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Document Version Revision History 


Date 


Document 
version 


Revision history 


Applicable IP 
and 
corresponding 
version 


2020-12-31 


V1.0 


a 


. Initial release. 


V1.0 


2021-01-12 


V1.1 


— 


. Detailed description of PHY debug interface. 


V1.1 


2021-01-20 


Vl.la 


jà 


. Adjust the PHY debug interface, delete the control interface 


for sending and receiving prbs code after eye diagram 
calibration, and add CK and DQS signal delay adjustment 
ports. 


Vl.la, V1.1b, 
Vl.lc, V1.ld 


2021-03-05 


W” Ne 


. PHY interface arrangement; 
. Add Ping Pong PHY description; 
. The description of the IP interface has been updated. 


2021-04-09 


V1.2a 


jà 


. The PHY interface is sorted and updated. 


V1.2a 


2021-04-30 


Ne 


Un Bw 


oo 


. Adjust the manual structure and standardize the format; 
. The document version revision record adds the "applicable 


IP and corresponding version" description column; 


. Add IP version change records; 
. Add "2.3.5 Resource Utilization"; 
. Update the Demo board model in the Example Design 


system block diagram in the "2.4.1 Design Block Diagram" 
section; 


. Add "2.6.2 Register Access"; 
. Updated the block diagram of the IP internal clock structure 


in the chapter "2.8.3 Clock Constraints"; 


. Add "2.9 IP debugging method". 


2021-07-14 


V1.3e 


N 


W 


n 


a 


oo 


Nel 


. Update the applicable device package information, see "2.1.2 


Applicable Devices and Packages"; 


. Update the Modelsim simulation script file name 


corresponding to ExampleDesign, see "2.3.1 3 Generate IP", 
"2.3.3 1 Modelsim Simulation"; 


. Update the ExampleDesign system block diagram, see "2.4.1 


Design Block Diagram"; 


. Added a detailed comparison between SimplifiedA XI4 and 


standard AXIA, see "2.5.2 1 SimplifiedA XI4 interface"; 


. Improve the Debug interface signal classification, see "2.5.3 


4 Debug Interface"; 


. Improve the Debug data description, see "2.5.5 Debug data 


description"; 


. For a detailed comparison between the newly added DFI 


interface and the standard DFI, see "2.5.4 1 DFI Interface 
Specification"; 


. Added typical applications in three scenarios of single 


BANK-x16, dual BANK-x32, and multiple BANK-x64, see 
"2.7.1 Typical application of single BANK-x16", "2.7.2 
Typical application of dual BANK-x32","2.7.3 Typical 
application of multiple BANK-x64"; 


. Delete wiring constraints and add related content of physical 


constraints, see "2.8.5 Physical constraints"; 


V1.3e 
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Date 


Document 
version 


Revision history 


Applicable IP 
and 
corresponding 
version 


10. Added dgsgateupdate function description, see "2.8.6 dqs 
gate update function description"; 

11. Add the reference document [12] UG050010 Titan2 series 
HMIC S IP application guide, and improve the relevant 
instructions of the manual; 

12. Add the IP version change record corresponding to V1.3e; 

13. Updated the glossary of terms and abbreviations, see "3.2 
Glossary" and "3.3 List of acronyms". 


2021-08-13 


V1.3f 


Ne 


Uo 


CA 


fon 


A 


oo 


. Update the IP selection interface, see "2.3.11 Select IP"; 

. Update the screenshot of ModelSim execution simulation 
script, see "2.3.3 | Modelsim simulation"; 

. Correct the footnote format of the table, see Table 2-3 and 
Table 2-15; 


4. Correct the packet length description related to the read and 


write timing of the address channel of the SimplifiedAXI4 
interface, see "2.5.21(1) Write address channel timing", 
"2.5.21(2) Read address channel timing"; 

. Correct the debug_data interface bit width in the normal 
debugging output signal, see Table 2-19; 

. Update the debug_calib_ctrl interface bit width in common 
debugging output signals, and update the definition and 
description of related fields synchronously, see Table 2-23; 

. Updated the debug interface description, added 5 debug 
interfaces (debug_rd_dq_dly_bin, debug_rd_dbi_dly_bin, 
debug_rdvref_mode, dbg_dram_vref_range, 
dbg_dram_vref_value), see Table 2-19; 

. Added a description of the default value of the IP interface 
configuration parameters, see "2.3.12 Configuring IP 
Parameters". 


V1.3f 


2021-08-18 


V1.4 


N 


— 


. Update resource utilization data, see "2.3.5 Resource 
Utilization"; 
. Update the IP selection interface, see "2.3.11 Select IP"; 


3. Add the IP version change record corresponding to V1.4. 


V1.4 


2021-09-15 


V1.4a 


W 


a 


. Add the IP version change record corresponding to the V1.4a 
version; 


2. Regulate document version revision records and IP version 


change record formats; 
. Add PDS version requirements, see "2.3.1 Module 
Instantiation"; 


4. Improve the description of Pin/BankOption and 


BasicOptions parameters, see Table 2-2 and Table 2-4; 


5. Complete the list of output files after IP generation, see 


Table 2-5. 


Vl.4a 


2021-09-30 


V1.4b 


N 


Ó 


. Add the IP version change record corresponding to V1.4b 
version; 

. Improve the description of module instantiation, update the 
screenshot of the IP selection path interface, see "2.3.1 
Module instantiation"; 

. Correct the default values of DebugSignals related 
parameters, see Table 2-2; 


Ow 


V1.4b 


UG052001 


www.pangomicro.com 


3/77 


[1h s TT: CD CUB 2 BIR LG] 


SHENZHEN PANGO MICROSYSTEMS CO.LTD 


Date 


Document 
version 


Revision history 


Applicable IP 


and 


corresponding 


version 


Nn 


fon 


a 


. Correct the cross-reference links related to the generated IP 


path description, see "2.3.1 3 Generate IP"; 


. Correct the packet length description related to the read and 


write timing of the SimplifiedA X14 interface address 
channel, see "2.5.2 1(1) Write Address Channel Timing", 
"2.5.2 1(2) Read Address Channel Timing"; 


. Refer to Table 2-19 to update the port names of the 


debugging interface (dbg dram vref left edge phyO, 
dbg dram vref margin win phyO, 
dbg dram vret value phyO); 


. Update the meaning description of the error status debug 


port related fields in debug calib ctrl, see Table 2-23. 


2021-10-28 


V1.4c 


jà 


a 


oo 


co 


. Add the IP version change record corresponding to the V1.4c 


version; 
Jpdate the text table style; 


U 
. Update the name of the text specification list, see Table 1-1; 
U 


Jpdate the format of the configuration parameter description 
list, and add the "IP configuration interface default value" 
olumn, see Table 2-2, Table 2-3, and Table 2-4; 

pdate the screenshot of the Basic Options page, and update 
he default values of Clock Frequency and EnableHardFifo 
onfiguration parameters, see Figure 2-6 and Table 2-2; 
pdate the screenshot of the Pin/Bank Options page, add the 
Enable fdc file select configuration parameter, and update 
the default values of the EnablePAR, EnableALERT n, and 
EnableTEN configuration parameters, see Figure 2-8 and 
Table 2-4; 


ct 


Cc eu 


. Improve the output file description after IP generation, see 


Table 2-5; 


. Update the maximum resource utilization table data, see 


Table 2-6. 


V1.4c 


2021-11-15 


V1.4d 


Ó 


N 


W 


D 


. Add the IP version change record corresponding to V1.4d 


version; 


. Improve the description of the "Enablefdcfileselect" option, 


and support the selection of fdc files through the dialog box, 
see Table 2-4; 


. Update the maximum resource utilization table data, see 


Table 2-6; 


. Update the debugging interface list, delete the original read- 


write manual window scanning port, see Table 2-19. 


V1.4d 


2021-11-26 


V1.4e 


n 


N 


Uo 


. Add the IP version change record corresponding to the V1.4e 


version; 


. Update the list of debug interfaces, and add read and write 


window scanning enable ports (wr win scan, en, 
wr win scan group en, rd win scan en, 
rd win scan group en), see Table 2-19; 


. Improve the DFI interface list on the Controller side and 


delete redundant ports (dfi reset n, dfi init complete, 
dfi error), see Table 2-13; 


. Added instructions related to the debugging interface, see 


"Notes". 


V1.4e 
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Applicable IP 
Date Document Revision history and 5 
version corresponding 
version 
1. Add the IP version change record corresponding to V1.5; 
2. Update the description of the maximum data rate of 
DDR3/DDR4, see "2.1.1 Main Features", Table 2-2; 
3. Update PDS version reguirements, see "Note"; 
4. Update the IP interface block diagram, see Figure 2-4; 
5. Update the Basic Options page configuration interface, add 
the option area "Memory Address Mapping Selection" and 
related options, and update the configuration IP parameter 
interface screenshots, Basic Options page screenshots, Basic 
Options page configuration parameter description list, see 
Figure 2-5, Fig. 2-6, Table 2-2; 
6. Update the resource utilization list and add resource utilization 
2021-12-31 V1.5 related to DDR4 Controller + PHY mode and DDR3 x64 V1.5 
configuration mode, see Table 2-6; 
7. Improve the Global interface list and add ZQCS related ports 
(ddr. zqcs req, ddr_zqcs_ack), see Table 2-7; 
8. Update the debug interface list, add the debug signals related 
to group data alignment errors in the read direction 
(align error clr, align error, align, error lck), and improve 
the description of the output port of the IOB output 
impedance calibration value, see Table 2-19; 
9. Add DDR4 Mode Register related description, see 
"2.6.1 1 Controller Internal Register"; 
10. Delete the original "Column Address Rounding Example" 
section. 
1. Add the IP version change record corresponding to the V1.5a 
version; 
2. Update the parameter description of Operating Mode, only 
PHY Only mode is supported, see Table 2-2; 
MORI VIDE 3. Update the resource utilization list and delete the content VAJA 
related to the Controller 4 PHY mode, see Table 2-6. 
4. For the description of legality check when adding CA pin 
constraints, see "Note". 
1. Add the IP version change record corresponding to V1.6; 
2. Update the software version description, see "Note"; 
3. Update the configuration interface of the Basic Options page, 
add the option area "DBI/DM Options" and related options, 
and update the screenshots of the configuration IP parameter 
interface, the screenshots of the Basic Options page and the 
2022-05-31 V1.6 list of configuration parameter descriptions, and the V1.6 
screenshots of the Summary page, see Figure 2-5, Figure 2-6, 
Table 2-2, Figure 2-9; 
4. Update the parameter description of Operating Mode, add 
support for Controller + PHY mode, see Table 2-2; 
5. Update the parameter description of Memory Part, add support 
for MT40A512MS8XX particle type, see Table 2-3; 
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Applicable IP 
Date Document Revision history and : 
version corresponding 
version 


6. Update the relevant description of the original Simplified 
AXIA interface to the standard AXIA interface, delete the 
detailed difference list between the original Simplified AXIA 
and the standard AXIA, and update the AXIA interface 
description and timing description synchronously, see 
"2.5.1 2 AXIA Interface", "2.5.2 1 AXIA interface"; 
. Update the description of port debug cpd offset dir, see 
Table 2-17; 
8. Add the description of simulation acceleration, see 
"2.3.3 Running Simulation". 

9. Add the description of the read data channel ready signal in 
the AXIA interface, see "2.5.1 2(4) Read Data Channel", 
"2.5.2 1(4) Read Data Channel Timing". 


J 


J= 


. Add the IP version change record corresponding to the V1.6a 
version; 
2. Update the configuration interface of the Basic Options page, 
add the option area "Rescal" and related options, and update 
2022-07-28 V1.6a the screenshot of the configuration IP parameter interface, the V1.6a 
screenshot of the Basic Options page and the list of 
configuration parameter descriptions, and the screenshot of 
the Summary page, see Figure 2-5 and Figure 2- 6. Table 2-2, 
Figure 2-9; 


re] 


. Add the IP version change record corresponding to V1.7; 


ete d . Update the version description of the software, see "Note". 


N 
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IP Version Change History 


IP Version 


Update description 


Release time 


V1.0 


. PG2T HMIC S IP initial version. 


2020-12-21 


V1.0 


. Organize the debug interface; 
. Open particle DLL by default; 
. Fix the problem that the MEM_BADDR_WIDTH parameter of the ddr_top 


layer is incorrect when instantiating IP; 


. Unencrypt several modules that are important for debugging; 
. Add FPGA vref voltage manual configuration function. 


2020-12-31 


V1.0 


. Adjust the TERM_OFF_SET and TERM_ON_SET parameters of 


GTP OSERDES E2 to solve the problem of reading and writing a single 
burst8 data error on the client-side dfi interface; 


. After modification, the board test of the demo board ddr4 1066x16 project 


is normal. 


2021-01-01 


. Add dfi, prbs module for dfi interface testing; 

. Adjust the term timing of dq and dqs; 

. Logic timing optimization; 

. Fix several bugs in IP; 

. When IP generates 1866 projects, the default parameters are optimized; 


The UI interface is fully functional; 


. Fix dqsp/dqsn waveform asymmetry problem. 


2021-01-16 


Vl.la 


r lA Lh LM HA 


N 


o 


. Add delay to CK and CKN output, and the delay value can be configured 


through the port; 


. Fix the problem of inaccurate calculation in the write calibration module 


window; 


. Fix the timing problem of dfi interface; 
. The delay adjustment function is added to the dqs clock in the read 


direction, and the delay can be increased or decreased through port 
configuration. 


2021-01-20 


V1.1b 


. Optimize the read and write window, and realize that the reference design 


vec can work normally without pressurization; 


. Add the testparam timing optimization parameter file to the reference 


design. 


2021-01-.22 


Vl.le 


. 1. The DDR3 function can be used normally; 
. 2. Optimize the reading calibration algorithm; 


3. Optimize the write calibration algorithm; 
4. Ul interface function optimization. 


2021-01-27 


Vl.ld 


Ne RON 


. Optimize the timing of ddrphy code; 
. Fix the problem that some dq write windows will jump when the client 


resets multiple times at low temperature. 


2021-02-02 


1. Add hardfifo enable option; 


Ww N 


oo JG tA A 


. Combine Ping-Pong PHY into IP; 
. Added the function of manually adjusting the window in the reading 


direction; 


. PHY timing optimization; 

. Optimize the clock structure and reduce the utilization of GPLL resources; 
. Reference design constraint optimization; 

. Optimized and updated the IP configuration interface; 

. The dqs gate algorithm is updated. 


2021-03-10 
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IP Version 


Update description 


Release time 


V1.2a 


. DFI interface bist function update; 
. Perfect IP function; 


PHY timing optimization; 
Fixed several bugs. 


2021-04-09 


MO 


Timing optimization; 


. Perfect reference design; 

. Change the low level of memory reset signal from 200us to 700us; 

. dqs gate algorithm optimization; 

. Modify the speed level range of CWL and CL parameters on the UI 


interface; 


. Optimize the IO constraint impedance value; 
. Add the same delay value to the CA signal. 


2021-04-30 


V1.3e 


AUN 


. Support skipping one or more training steps, and force training results 


through the port; 


. Support manual scan of write data window; 
. Optimized dgs gate update function; 
. When a training error occurs, the exact error steps can be reported through 


the error status port. 


2021-07-19 


v1.3f 


. Equipment test function bug fix; 
. Read vref training scheme optimization; 
. Some bug fixes for ddr3 controller. 


2021-08-13 


Realize resource optimization on the basis of 1.3f; 


. The read vref training optimization not included in 1.3f. 


2021-08-18 


V1.4a 


. Incorporate into vref training optimization in 1.3f; 
. Debug port optimization, add group grouping mode; 
. UG update. 


2021-09-15 


V1.4b 


N 


W 


. Fix the problem that the interface configuration changes after the idf file is 


reloaded; 


. Fix the problem that the left and right sides of the writing window are 


asymmetrical; 


. UG update. 


2021-09-30 


V1.4c 


1. Resource optimization in PP PHY mode, two PHYs share the read-write 


ON ta ROO H 


24 


calibration module; 


. Add optional training 1bit function; 
. Added the function of importing FDC; 


The default reference design can run through the flow; 


. Fix XA-581; 
. Fix the problem of rdvref fine training failure when opening dm and reading 


dbi; 
When DM calibration is enabled, the problem that DM is closed after 
training is completed; 


. Partial logic timing optimization; 
. UG update. 


2021-10-28 


V1.4d 


. Optimization of reading and writing calibration resources; 
. Delete the original read-write manual window scanning port, and use the 


force port to achieve the same function; 


. Write the calibration window information, simplify the debug port, and only 


keep the window information of bit0; 


. Training process optimization; 
. UG update. 


2021-11-13 
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IP Version 


Update description 


Release time 


V1.4e 


AUN- 


. Add the function of writing vref fine calibration; 
. Add read-write window scan enable port; 

. Code optimization, delete invalid logic; 

. UG update. 


2021-11-26 


V1.5 


Uo LA 


UAR 


. DDR4 supports Controller+PHY mode; 
. Added address mapping option in Controller+PHY mode; 
. Improve AXI BIST and DFI BIST functions, and support DDR3 and DDR4 


at the same time; 


. Optimize DDR4 RTP parameter configuration; 
. Fix the problem that Controller read and write commands cannot cross 


ROW and BANK; 
The highest rate of DDR4 supports up to 2000Mbps; 


. The reference design adds some internal signal muticycle constraints; 
. Improve debug information; 


UG update. 


2021-12-31 


Vi.5a 


. Repair DDR3 800M board, emulation is not normal; 
. Perform legality check when IP manually constrains CA pins; 
. Fix the problem of asymmetry between the left and right windows of the 


sampling point when reading the eye diagram and manually scanning; 


. Fix the problem that the data bit width on the interface changes when 


reloading idf after generating IP; 


. Limit the Operating Mode to PHY Only mode; 
. UG update. 


2022-01-21 


V1.6 


1. Fix the problem that the synthesis file in the IP index file cannot be flexibly 


adapted to different modes; 


. Added DBI and DM configuration options on the UI interface; 

. Added support for DDR4 X8 particle types on the UI interface; 

. Add training result printing in simulation; 

. Fixed the problem that training failed when write calibration was disabled; 
. Fixed the problem of training failure when using DDR3 force rdcal; 

. Controller is upgraded from Simplified AXIA interface to standard AXI4 


interface; 


. Improve DM signal DDR3 as OUTPUT type, DDR4 as INOUT type; 
. The enable fifo signal is divided according to the group, and the enable fifo 


signal in the same bank is restricted to a fixed area; 


10. UG update. 


2022-05-31 


V1.6a 


. When adding DDR3 on the interface, you can choose whether to use the 


RESCAL function; 


. Fix the problem of probabilistic initialization of DDR3 800M; 
. When the Controller--PHY mode is restricted on the interface, the data bit 


width can only be selected as 8, 16, 32, 64; 


. UG update. 


2022-07-28 


V1.7 


I9»! 


When adapting to write leveling, the initial delay of ck is less than the initial 
delay of dqs; 

Repair possible risks in the case of discontinuous read data validity; 

UG update. 


2022-09-01 
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Chapter 1 Preface 


Chapter 1 Preface 


This chapter describes the scope of application of this manual, the structure of the manual and 


related writing rules, helping users guickly find the reguired information. 


About this manual 


This manual is a user guide for HMIC_S (High performance Memory Interface Controller Soft 


core) IP, a DDR4 IP launched by Tsinghua Unigroup. The IP is implemented based on the HPIO 


resources of Titan2 series FPGA products and is compatible with DDR3. The content of this manual 


mainly includes IP usage guide and related appendices. Through this manual, users can quickly 


understand the relevant features and usage methods of HMIC_S IP. 


Specifications of the manual 


Table 1-1 Specifications for writing 


Text Usage Principles 
Agnan If the user ignores the attention content, it may cause certain adverse 
conseguences or fail to operate successfully due to misoperation. 
Description | Instructions and tips provided to the user. 
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Chapter 2 IP Usage Guide 
This chapter describes the related usage guide of HMIC_S IP, including IP introduction, IP block 


diagram, IP generation process, Example Design, IP interface description, IP register description, 
typical application, instructions and precautions, and IP debugging methods. More detailed information 


about the design process can be found in the following PDS help documents. 


€  Pango Design Suite Quick Start Tutorial[1] 


€  Pango Design Suite User. Guide[2] 


€ IP Compiler User. Guide[3] 
€ Simulation User Guide[4] 


2.1 Introduction to IP 

HMIC S IP is a DDR4 IP launched by Tsinghua Unigroup. It is based on the HPIO resources of 
Titan2 series FPGA products to realize SDRAM reading and writing. It is compatible with DDR3 and 
can be completed by the IPC (IP Compiler) tool in the company's PDS (Pango Design Suite) suite. 


Configure and generate. 


2.1.1 Main Features 
The main features of the HMIC_S IP product are as follows. 


€ Support DDR3, DDR4, DDR4 ping-pong PHY; 

€ Support a maximum data bit width of 72bit (Ping-Pong PHY maximum 32bit); 

€ User interface: AXIA bus interface, APB bus interface; 

€ Support configurable low power consumption modes: Self-Refresh and Power Down; 
€ Support the highest data rate of DDR3 up to 1866Mbps; 

@ Support the highest data rate of DDR4 up to 2000Mbps; 

€ Burst Length 8 and single Rank; 

€ PHY can be used independently. 


2.1.2 Applicable devices and packages 


Table 2-1 HMIC_S IP Applicable Devices and Packages 


Applicable Device Package Type Support 
PG2T390H FFBG900 
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2.2 IP Block Diagram 
The block diagram of the HMIC_S IP system is shown in Figure 2-1. HMIC_S IP provides two 
modes of Controller + PHY and PHY Only. 


HMIC_S IP 
DDR Controller 
Rdata 
Read Data Channel ^7 Pah | 
. "I Wdata " 
Write Data Channel Path 
Write Address Channel m 
hes — DCD j—> DCP —P DDR 
AXI 
DDR PHY e SDRAM 
Read Address Channel ~<¢ 
DFI a 
Convert 
—— LP udi 
Config interface » CFG 
APB 
— MRS » 


Figure 2-1 HMIC S IP system block diagram 


2.2.1 Controller + PHY 
In this mode, the IP includes the functions of DDR Controller and DDR PHY. Users can read and 


write data through the AXI4 interface, and realize low power consumption and MRS control through 


the APB interface. 
€  AXl4interface 


The interface includes four parts: write address channel, read address channel, write data channel 


and read data channel. 


The user initiates read and write operations through the write address channel and the read address 
channel; the commands are parsed into Controller internal commands in the UI AXI module; 


decomposed into DDR corresponding commands in the DCD (DDR Command Decode) module; 
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Implement DDR-based timing control in the DCP (DDR3 Command Procedure) module; convert 
it into a DFI interface in the DFI Convert module and pass it to the PHY, and finally pass it to the DDR 


Memory interface. 


The write data is directly passed to the DDR PHY through the write data channel interface through 
the Wdata Path module, and finally passed to the DDR Memory interface. 


The read data from DDR Memory is sampled and analyzed by DDR PHY, synchronized by the 


Rdata Path module, and returned to the user through the read data channel interface. 
€ Config Interface 


This interface is an APB configuration interface, through this interface, users can read the status 


of DDR SDRAM to realize low power consumption and MRS control. 


2.2.2 PHY Only 
In this mode, users need to realize the design of the Controller by themselves, and interface with 


the PHY through the DFI interface to realize the operation of the DDR SDRAM. 


2.3 IP generation process 
2.3.1 Module Instantiation 

The customized configuration of HMIC_S IP can be completed through the IPC tool, and the 
required IP modules can be instantiated. For the specific usage of IPC tools, please refer to 


IP Compiler User Guide[3]. 
The main operation steps of HMIC_S IP module instantiation are described as follows. 


1. Select IP 
Open IPC, click File-> Update in the main window to open the Update IP dialog box, and add the 


IP model of the corresponding version. 


After selecting the device type of FPGA, the Catalog interface can display the loaded IP model. 
Select the corresponding version of DDR4 Interface under the System/DDR/Soft directory, and the IP 
selection path interface is shown in Figure 2-2. Then set the Pathname and Instance Name on the right 


page, and the project instantiation interface is shown in Figure 2-3. 
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Attention: 


Software must be version 2022.1 and above. 


IP (16/71) 
[+ Module 
E System 


Figure 2-2 HMIC S IP selection path interface 


Pathname D:\TEST\ipcore\test\test.idft | Browse. me | Proj Path 


Instance Name test 


Figure 2-3 Project instantiation interface 


2. Configure IP parameters 
After the IP is selected, click <Customize> to enter the HMIC_S IP parameter configuration 
interface. The Symbol on the left is the interface block diagram, as shown in Figure 2-4; the right is the 


parameter configuration window, as shown in Figure 2-5. 
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Symbol 


ref clk 

ddr rstn 

dfi address[67:0] 

dfi bank[7:0] 

dfi cs n[3:0] 

dfi bg[3:0] 

dfi act n[3:0] 

dfi cke[3:0] 

dfi odt[3:0] 

dfi wrdata en[3:0] 

dfi wrdata[127:0] 

dfi wrdata mask[15:0] 
dfi reset n 

dfi phyupd ack 

mem alert n 

mem das [1:0] 

mem das n[1:0] 

mem dq[15:0] 

mem dm[1:0] 

gate update en 

dbg manu gate upd en 

dbg manu gate upd sta 
init wrlvl step[15:0] 
init slip step[7:0] 

init read clk ctrl[5:0] 
rescal pcodel bank [4:0] 
rescal pcode2 bank [4:0] 
rescal ncodel bank0 [4:0] 
rescal ncode2 bank0 [4:0] 
rescal pcodel bankl[4:0] 
rescal pcode2 bankl[4:0] 
rescal ncodel bankl[4:0] 
rescal ncode2 bankl[4:0] 
rescal pcodel bank2 [4:0] 
rescal pcode2 bank2[4:0] 
rescal ncodel bank2[4:0] 
rescal ncode2 bank2[4:0] 
rescal rst 

align error clr 

wr dgs dly adj[7:0] 

ck dly set bin[7:0] 

das even adj [7:0] 

dqs odd adj [7:0] 

gate dqs sample sel 

left err sure num[4:0] 
right err sure num[4:0] 
upd act ba[l1:0] 

upd act bg 

force wrlvl 

force dgsgate 

force rdvref 

force rdcal 

force wrvref 

force wrcal 

force wrlvl step[15:0] 
force read clk ctrl[5:0] 
force slip step[?:0] 
force rdvref range 

force rdvref value[11:0] 
force rd dg d1y[127:0] 
force dqs even dly[15:0] 
force dgs odd dly[15:0] 
force rd dbi dly[15:0] 
force wrvref range 

force wrvref value[5:0] 
force wr dg dly[127:0] 
force wrdm dbi dly[15:0] 
wr win scan en 

wr win scan group en[1:0] 
rd win scan en 

rd win scan group en[l:0] 


pll lock 
ddrphy cpd lock 
ddrphy sysclk 

ifi rddata[127:0] 

dfi rddata valid 

ifi phyupd reg 

ifi init complete 
dfi error 

ddrphy update done 


em rst n 


em a[16:0] 
em ba[1:0] 
debug data[121:0] 
debug calib ctr1[35:0] 
debug rdvref margin win[13:0] 
debug rdvref left edge[11:0] 
iebug rdvref mode[11:0] 
debug eye dq win[15:0] 
debug dq dly bin[127:0] 
debug eye dm win[15:0] 
debug dm dly bin[15:0] 
iebug rd dg dly bin[127:0] 
debug rd dbi dly bin[l15:0] 
das drift[3:0] 
| update done 
dbg dram vref value phy0[5:0] 
dbg dram vref left edge phy0 [5:0] 
dbg dram vref margin win phy0[6:0] 
dbg dram vref range 
pcode out[14:0] 
ncode out[14:0] 
lign 0 error 
lign 0 error lck 
left sample error[21:0] 
ight sample error[31:0] 
left sample err sure[l:0] 
ight sample err sure[1:0] 
left adj cnt[15:0] 
ight_adj_ent [15:0] 
no adj cnt[15:0] 


Figure 2-4 HMIC S IP interface block diagram 
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r Type Options 


Please select the memory interface type from the Memory Type selection. 


Memory Type: DDR4 v 


r PingPong PHY 


| | Enable PingPong PHY 


r Mode Options 
Please select the operating mode for memory Interface. 


Operating Mode: PHY Only v 


r- Width Options 
Please select the data width which memory interface can access at a time. 


Total Data Width: 16 v 


r Clock settings 


Input Clock Frequency: 133.333 7  MHz(range:20-800MHz) 
Desired Data Rate: 1600.000 7  Mbps(range:1600-2000Mbps) 
Actual Data Rate: 1599.996 Mbps 


r Write and Read Latency 


CAS Write Latency(CWL): 9 w  tCK(range: 9,11) 
CAS Latency(CL): 12 V  tCK(range: 9-14) 
Additive Latency(AL): 0 v | tCK 


r Debug Signals 


Enable Debug Signals 


r Hard FIFO 


M] Enable Hard FIFO 


Rescal 


M Enable Rescal 


r- DBI/DM Options 
Write: DBI v 


Read: DBI v 


Figure 2-5 Configure HMIC S IP parameter interface 
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Attention: 


Please make sure to configure the IP parameters according to the page order, that is, Step 1 — 


Step 2 — Step 3 — Step 4. 


The parameter configuration is divided into four pages, namely Stepl: Basic Options, 
Step2: Memory Options, Step3: Pin/Bank Options, and Step4: Summary. The HMIC S IP 


configuration steps are described below. 


(1) Step 1: Basic Options 
Basic Options is the basic configuration page of IP, the interface is shown in Figure 2-6, and the 


detailed parameters are shown in Table 2-2. 


Spa R Es Av], Step 2: Memory Options Step 3: Pin/Bank Options Step 4: Summary 


Type Options 
Please select the memory interface type from the Memory Type selection. 


Memory Type: DDR4 v 
PingPong PHY 

| Enable PingPong PHY 
-Mode Options 


Please select the operating mode for memory Interface. 


Operating Mode: PHY Only v 


Width Options 
Please select the data width which memory interface can access at a time. 


Total Data Width: 16 v 


Clock settings 


Input Clock Freguency: 133.333 > MHz (range:20-800MHz) 
Desired Data Rate: 1600.000 7 Mbps (range:1600-2000Mbps) 
Actual Data Rate: 1599.996 Mbps 


Write and Read Latency 


CAS Write Latency (CWL): 9 VV  tCK(range: 9,11) 
CAS Latency (CL): 12 V  tCK(range: 9-14) 
Additive Latency (AL): 0 wv | tCK 


Debug Signals 


[ | Enable Debug Signals 


Hard FIFO 


M] Enable Hard FIFO 


DBI/DM Options 
Write: DBI v 


Read: DBI v 


Figure 2-6 Basic Options page 
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Table 2-2 Description of configuration parameters on the Basic Options page 


IP 
Options Parameters/configuration Dorset Dese itum configuration 
area options interface 
default value 
T The type of SDRAM used, the currently supported types are: 
orm Memory Type 1) DDR4; DDR4 
P 2) DDR3. 
PingPong ; DDRA ping-pong PHY enable selection. 
PHY Enable PingPong PEY Can be selected when Memory Type is DDR4. No Eranio 
HMIC_S Operating mode selection. The available operating 
Mode ; modes are: 
Options Operating Mode 1) PHY Only; PHY Only 
2) Controller + PHY. 
Select the read-write address mapping method of the 
Memory o s Controller AXI interface as: "ROW + BANK + COLUMN", | Checked 
Address see Figure 2-16. 
Mapping BANK + ROW + Select the reading and writing address mapping method of the 
Selection Controller AXI interface: "BANK + ROW + COLUMN", see | Unchecked 
COLUMN j 
Figure 2-17. 
Total DQ width of off-chip SDRAM connected to HMIC S. 
The total widths currently supported are: 
1) 72; 
2) 64; 
taji 3) 56; 
Width | Total Data Width? 4) 48; 16 
P 5) 40; 
6) 32; 
7) 24; 
8) 16; 
9) 8. 
Input Clock Frequency The input clock of HMIC S, the unit is MHz. 133.333 
Desired data rate in Mbps. 
Clock Desired Data Rate DDR3 supports a maximum rate of 1866Mbps. DDR4 1600 
settings supports a maximum rate of 2000Mbps. 
Actual Data Rate The actual achievable data rate, as close as possible to the | 
desired rate. 
CAS Wirite : : ae 
Write and. | Latency(CWL) CAS Write Latency configuration, the unit is tCK. 9 
PR CAS Latency(CL) CAS Latency configuration, the unit is tCK. 12 
Additive Latency(AL) Additive Latency configuration, unit tCK. 0 
Sen Enable Debug Signals Debug signal enable configuration. Not Enabled 
Hard FIFO | Enable Hard FIFO Hardware circuit FIFO enable selection between IO Serdes Enabled 
and Fabric. 
Rescal Enable Rescal? RESCAL is enabled. Enabled 


! This option area is only displayed in "Controller + PHY" mode. 
2 In Controller+PHY mode, the data bit width can only be 8, 16, 32, 64. 
3 When the Memory Type is configured as DDR4, Rescal is enabled by default; when the Memory Type is configured as DDR3, Rescal 


is supported. 
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IP 
ti P t fi ti ds fi ti 
Op 1lons arameters/ con 1guration Parmer Descrip lem con guration 
area options interface 
default value 
DBI/DM Write Write direction configuration. DBI 
Options Read Read direction configuration. DBI 
Note: "-" indicates that the IP configuration interface has no default value for this parameter. 


(2) Step 2: Memory Options 


Memory Options is the configuration page of Memory parameters, the interface is shown in Figure 


2-7, and the detailed parameters are shown in Table 2-3. 


Step 1: Basic Options [Ss E Saves Step 3: Pin/Bank Options Step 4: Summary 


Memory Part 


Please select the memory part.Find an eguivalent part or create a part using the 'Create Custom Part' button if the part you want is not listed here. 


Create Custom Part 


Drive Options 


MT40A512M16XX-075-IT v 


To calibrate the output driver impedance, an external precision resistor (RZQ) is connected between the ZO ball and VSSQ. 


The value of the resistor must be 240ohm 4/-l percent. 


Output Driver Impedance Control: RZQ/7 


The ODI feature is designed to improve signal integrity of the memory channel by enabling the DDR4 SDRAM controller to 


independently turn on/off ODT. 


RIT (nominal) -ODT: RZQ/4 


Figure 2-7 Memory Options page 


Table 2-3 Description of configuration parameters on the Memory Options page 


: Parameters / : : 
Options : mor IP configuration 
configuration Parameter Description : 
area : interface default value 
options 
IDDR3 supported models are: 
1) MT4IJ128M8XX-15E; 
2) MT41J64M16XX-15E; 
3) MT41J256M8XX-15E; 

SDRAM 47 MT41J128M16XX-15E; MT40A512M16XX- 
device : 075-IT 
model 5) MT41J512M8XX-15E; 

» 60 MT41J256M16XX-15E; 
nd IDDR4 supported models are: 
1? MT40A512M16XX-075-IT; 
2) MT40A512M8XX. 
(Customize new SDRAM type enable selection. 
If the above device models supported by the IP do not meet 
Create the requirements, the user can check this option and 
Custom ^ customize a new one based on the reference model in the Unchecked 
Part (Custom Memory Part option box below. 
SDRAM type. 
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: Parameters / TER 
Options e IP configuration interface 
configuration Parameter Description 
area : default value 
options 
Select Base Part | Reference model for custom SDRAM. MT40A512M16XX- 075-IT 
trfc: 350 
tras: 35 
trp: 12.5 
Timing Customize the timing parameters of SDRAM, trcd: 12.5 
Parameters including: trfc, tras, trp, trcd, twr, trefi, trtp, twtr. twr: 15 
Custom trefi: 7.8 
Memory trtp: 7.5 
Part twtr: 7.5 
Row Address Row address. 16 
Column 
Address Column address. 10 
Bank Address | Bank address. 2 
Bank Groups Bank Groups address (DDR4 only). 1 
Output Driver 
Impedance Drive capability options. RZQ/7 
Drive | Control For details, please refer to: JESD79-3D, DDR3 
Options f SDRAM Standard[9], JESD79-4B, DDR4 SDRAM 
M - | Standard[10]. RZO/4 


(3) Step 3: Pin/Bank Options 
Pin/Bank Options is the interface parameter configuration page, the interface is shown in Figure 


2-8, and the detailed parameters are shown in Table 2-4. 


Attention: 


All configuration items in "Step 3: Pin/Bank Options" must be configured according to the pin 
assignment on the actual board. After generating the IP, constrain the pin positions of the DQ signal, 
reset signal, and status signal according to the pin assignment on the actual board, otherwise errors may 


occur when running Flow. 


4 This option box is displayed when the "Create Custom Part" option is checked, and it is used to customize a new SDRAM type. 
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Step 1: Basic Options Step 2: Memory Options [22-15-19 iis") alesis) Step 4: Summary 


Memory Pin Contraint File Select 


Please select a fdc file which contains default memory pins constraint. 


Enable fdc file select 


Control/Address Pin Options 


Please select the banks for the Control/Address in the architectural view below. 


Control/Address Bank: 


Ré v 


Please select the pins for the Control/Address in the architectural view below. 


M Enable 
M Enable 
\/| Enable 


M Enable 


Chapter 2 IP Usage Guidelines 


CS n(if cs n is disabled,it should be considered NF maintained LOW through an external resister to GND) 


PAR (Command and Address Parity Input) 


ALERT n 


TEN (Connectivity Test Mode Enable,if not use,The pin should be kept low) 


Please select the groups for the Control/Address in the architectural view below. 


Data Pin Options 


L] Custom Control/Address Group 


Please select the banks and groups for the data in the architectural view below. 


Signal Name 


DQ[0-7] 


DO[8-15] 


Rescal Mode 


Please select the rescal mode in the architectural 


Options 


Bank Number 


Ré 


R7 


Bank Number Group Number 


R7 v so v 


R7 v G1 v 


view below. 


Rescal Mode Adjacent Bank Options 


Internal v LOCAL v 
Internal v LOCAL v 


Figure 2-8 Pin/Bank Options page 


Table 2-4 Description of Pin/Bank Options page configuration parameters 


Parameters / 


IP configuration 


Options area | configuration Parameter Description interface default 
options value 
Custom fdc files can be imported. 
When enabled, you can enter the path of the user's fdc file in 
the text box, or select the fdc file through the dialog box, and 
Memory Pin Enable fde file the Memory interface constraints in the fdc file will be 
Contraint File automatically read, and the Control/Address and Data Pin in the | Not Enabled 
select : 
Select UI will be configured. 
Note: The signal name of the Memory interface in user fdc 
must be consistent with the signal name of the Memory 
interface in Example Design. 
Control/ The bank where the control and address lines of the Memory R6 
Address Bank _ | interface are located 
Control / Enable CS n mem cs n signal enable selection. Enabled 
Address Pin | Enable PAR mem parity signal enables selection. Enabled 
Options Enable ; : 
ALERT n mem alert n signal enable selection. Enabled 
Enable TEN mem ten signal enables selection. Enabled 
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Parameters / IP configuration 
Options area | configuration Parameter Description interface default 
options value 


User-defined control and address bus group enable selection. When 
checked, the user can customize the grouping and pin assignment 
of each PAD, and when not checked, the default grouping will be 


Custom 

Control / adopted. 

Address The default grouping is as follows: Unchecked 
Group Control/Address-0: CKE, CK, CKN, CS, RAS, CAS, WE, ODT, 


BAO, BA1, BA2, ALERT, ACTN, PARITY. 
Control/Address-1: BGO, BG1, AO, Al, A2, A3, A4, A5, A6, A7. 
Control/Address-2: A8, A9, A10, A11, A12, A13, A14, A15, A16. 


Control and | This option box is displayed when the "Custom Control/Address 


Address Group" option is checked, and is used to select the Group and Pin |- 
Signals where the control and address signals correspond to the PAD. 
: Bank Number | Select the Bank where DQ? is located. R7 
Data Pin G DQ[0-7): GO 
Options TOUP 5 9 
D Number Select the Group where DO" belongs to. DOI8-15]: G1 
Three optional calibration modes are supported. 
1) Internal: Internal mode, this Bank IOB uses the calibration value 
of this Bank; 
2) Adjacent Bank: Adjacent Bank mode, this Bank IOB uses the 
Rescal Mode" Ga ana value of the adj acent Bank, specifically set with the Thermal 
Rescal Adjacent Bank Options" option; 
Mode 3) User Config: user configuration mode, the user can configure 
Option the calibration value by himself. For detailed usage of 
GTP. RES CAL El, please refer to: 
"UGO50007 Titan2 Series GTP User Guide" [8]. 
Adjacent Corresponding to "Adjacent Bank" calibration mode, it supports 
Bank two options of UP and DN. This parameter is determined - 
Options according to BANK selection. 
Note: "-" indicates that the IP configuration interface has no default value for this parameter. 
Attention: 


* For the "Custom Control/Address Group" option, it is recommended to use a custom group 


because the PCB routing is different in actual use. 


* When checking the "Custom Control/Address Group" option for custom pin configuration, make 
sure not to constrain the signals to the same pin. If there are pins bound to the same position, the UI 


interface will be marked in red to prompt the corresponding Pin Number. 


5 DQ[8-15] is displayed when the data bit width is greater than 8, DQ[16-23] is displayed when the data bit width is greater than 16, 
DO[24-31] is displayed when the data bit width is greater than 24, DQ[32-39] ] is displayed when the data bit width is greater than 32, 
DO[40-47] is displayed when the data bit width is greater than 40, DQ[48-55] is displayed when the data bit width is greater than 48, 
DQ[56-63] is displayed when the data bit width is It is displayed at 56, and DQ[64-71] is displayed when the data bit width is greater 
than 64. 


$ IOB output impedance calibration option. 
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(4) Step 4: Summary 


Chapter 2 IP Usage Guidelines 


The Summary page is used to print the current configuration information, no configuration 


parameters are reguired, as shown in Figure 2-9. 


Step 1: Basic Options Step 2: Memory 


Basic Options 


Memory Type DDR4 
PingPong PHY Disabled 
Operating Mode PHY Only 
Total Data Width 16 
Density 8Gb 

Volt 1.2V 


Input Clock Frequency 
Data Rate 


133.333MHz 
1599.996Mbps 


Mon non nom oom non non on on 


Debug Signals Disabled 
Hard FIFO Enabled 
Rescal Enabled 
Write DBI Enabled 
DM Disabled 
Read DBI Enabled 


Memory Options 


Memory Part 


MI40A512M16XX-075—IT 


Options Step 3: Pin/Bank Options 


Row Address z: 16 
Column Address z 10 

Bank Address = 2 

Bank Groups = ' 

Output Driver Impedance Control z RZQ/7 
RIT (nominal) -—ODT = RZQ/A 
Pin/Bank Options 

Control/Address Bank z RE 

CS n z Enabled 
PAR z Enabled 
ALERT n z Enabled 
TEN : Enabled 
DQ[O-7] Bank z R7 
DQ[8-15] Bank S R7 

R6 rescal z: Internal 
R7 rescal z Internal 


Figure 2-9 Summary page 


3. Generate IP 
After the parameter configuration is complete, click the <Generate> button on the upper left corner 
to generate the HMIC_S IP code corresponding to the user-specific settings. Figure 2-10 shows the 


report interface for generating IP information. 


Done: 0 error(s), 0 warning (s) 


Figure 2-10 HMIC S IP generate report interface 


Attention: 


The .pds file and .fdc file generated by the IP are for reference only, please change the pin 


assignment according to the actual pin connection when using it. 


21/17 
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After the IP is successfully generated, the files shown in Table 2-5 will be output under the Project 


path specified in Figure 2-3. 


Table 2-5 Output Files After IP Generation 


Output File’ Description 


$instname.v The top-level .v file for the Controller 4 PHY of the generated IP. 


$instname_ddrphy_top.v | The PHY top-level .v file for the generated IP. 


$instname.idf Configuration file for generated IP. 


/rtl/* RTL code file for generated IP. 


The Test Bench used by the Example Design of the generated IP and the corresponding 


1 * 
lepe a Memory Simulation Model file. 


The corresponding project file .pds and pin assignment file .fdc of the generated IP 


sk 
/pnr/ Example Design. 
Isim/* Simulation directory for generated IP. sim.tcl is modelsim simulation script, makefile is 
ves simulation script, sim_file_list.f is simulation file list. 
/sim_lib/* Directory of encrypted files required by IP. 
Irev 1 Comprehensive report default output path. (This folder will only be generated if the 
= synthesis tool is specified) 
readme.txt readme file, describing the structure of the generated directory after the IP is generated. 


2.3.2 Constraint Configuration 

For the specific configuration method of the constraint file, you can refer to the relevant help 
documents under the PDS installation path: User Constraint Editor User Guide[5], 
Physical Constraint Editor User Guide[6] , Route Constraint Editor User Guide[7]. 


2.3.3 Run Simulation 
The simulation of HMIC S IP is based on the Test Bench of Example Design. For details about 
Example Design, see "2.4 Example Design". 


In the simulation application of HMIC S IP, you can achieve acceleration and reduce simulation 
time by defining the macro IPS DDR SPEEDUP SIM. The recommended definition method is as 
follows: Add the statement in the sim file list.f file under  ../sim/modelsim or 


../sim/vcs+define+IPS_DDR_SPEEDUP_SIM. 


For more detailed information about the PDS simulation function and third-party simulation tools, 
you can refer to the relevant help documents under the PDS installation path: 


Pango Design Suite User Guide[2], Simulation_User_Guide[4]. 


7 $instname is the instantiated name entered by the user; "*" is a wildcard, replacing files of the same type. 


UG052001 www.pangomicro.com 28/77 


ie ut Vu r^ 4N 5 
[ph Sim zala TEMA 
SHENZHEN PANGO MICROSYSTEMS CO.LTD Chapter 2 IP Usage Guidelines 
1. Modelsim simulation 
Simulation running steps: Open cmd.exe, switch the current directory to /sim under the IP 
generation directory in the command line, run vsim, and open the ModelSim simulation software, as 


shown in Figure 2-11. 


E Stem: C:\Windows\system32\cmd.exe cai 28 


ID: NDDR*DDR. PGL. TEST \ddr3_866Ns im>vsim 


Figure 2-11 Open ModelSim command 
Run the sim.tcl script in the ModelSim simulation software to perform simulation, as shown in 


Figure 2-12. 


f] Transcript 
// Questa Sim 
Version 10.6c win32 Jul 26 2017 


// Copyright 1991-2017 Mentor Graphics Corporation 
// All Rights Reserved. 


QuestaSim and its associated documentation contain trade 

secrets and commercial or financial information that are the property of 
// Mentor Graphics Corporation and are privileged, confidential, 

and exempt from disclosure under the Freedom of Information Act, 

5 U.S.C. Section 552. Furthermore, this information 

is prohibited from disclosure under the Trade Secrets Act, 

18 U.S.C. Section 1905. 


4 
# 
ž / 
# 
$ 
id 
$ / 
$ / 
4 
# 
# 
# 
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Figure 2-12 ModelSim executes the simulation script 


2. VCS simulation 
Enter the sim/vcs directory in Terminal, enter make and press Enter to start the simulation, as 


shown in Figure 2-13. 
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File Edit View Search Terminal Help 


ITCSERVER35{dingwei}:[/localhome/design temp/dingw/PG2L/PG2L100H/pg2l ddr/sim vcs/ddr3 1066x16 sim test/sim/vcs]% ll E 
total 20 

-DW-p----- . 1 dingwei AE IP 541 Sep 24 14:37 makefile 

-TW-T-----., ingwei AE IP 15023 Sep 24 11:04 sim file list.f 

ITCSERVER35(dingwei):[/localhome/design temp/dingw/PG2L/PG2L100H/pg2l ddr/sim vcs/ddr3 1066x16 sim test/sim/vcs]% makelj 


Figure 2-13 VCS executes the simulation script 


2.3.4 Synthesis and Place and Route 
For the specific usage of PDS synthesis tools and place and route tools, please refer to the help 


documents under the PDS installation path. 


Attention: 


The Example Design project file .pds and pin assignment file .fdc generated together with the IP 
are stored in the /pnr/ directory. When using it, it is necessary to modify the physical constraints 


according to the actual wiring of the board. For details, please refer to "2.8 Description and Precautions". 


2.3.5 Resource Utilization 


Table 2-6 HMIC S IP Typical Resource Utilization Based on Applicable Devices 


Resource Utilization Typical 
Device Configuration Mode 
LUT FF GPLL PPLL | USCM 
DDR4 x32 
PHY Only 7435 7692 1 2 2 
DDR4 x64 
PHY Only 11482 12633 1 3 2 
DDR4 PPPHY x32 

PG2T390H PHY Only 11147 12205 1 3 2 
DDR3 x32 
PHY Only 6974 7600 1 2 2 
DDR3 x64 
PHY Only 8824 10259 1 3 2 
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2.4 Example Design 

This section mainly introduces the Example Design solution based on HMIC_S IP (Controller + 
PHY mode). In this solution, the user logic acts as the AXI Master, and the HMIC_S IP acts as the AXI 
Slave. The user logic writes data through the Write channel of the AXI interface, and receives and 
compares the data through the Read channel of the AXI interface. If the data is wrong, the Error LED 
will be lit. 


2.4.1 Design Block Diagram 


PC 
P051330KF01. A2 
test ddr 
uart ctrl 
A status bus lock 
uart_rd_lock 
T status bus 
H status merge l 
control bus TEA sanss signals 
ips ddr to 
d test wr JAN ps ddr lop 
_ctrl 
DFI 
test_main DDR3 
p «——— ——» RAM 
ctrl ddrc top ddrphy top SD 
test rd 
_ctrl 


Figure 2-14 Example Design system block diagram 


The system block diagram of Example Design is shown in Figure 2-14, where the test_main_ctrl 
module is the control module for AXI read and write instructions, the test wr ctrl module is the control 
module for AXI write instructions and write data, and the test_rd_ctrl module is the control module for 
AXI read instructions and read data, the uart ctrl module is a serial port conversion module, which is 


convenient for controlling and reading the internal state during debugging. 
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2.4.2 Test method 
In Example Design, the user logic reads and writes the HMIC_S IP and verifies the readback data. 


The detailed test process is shown in Figure 2-15. 


Start 


Power-on reset 
or hard reset 


| 


HMIC_S IP 
Initialization 


ni E 


Initialization 
complete? 


Yes 


Write Data 


DDR are Full? 


Write Data 


Read and 
check data 


Is the Data wrong? 


Finish | 
(Fin >) 


Figure 2-15 Example Design test flow chart 
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After the system is powered on or hard reset is started, HMIC S IP starts to execute initialization. 
After the initialization is completed (ddrc init done is pulled up), the test main ctrl module controls 
the test wr ctrl module to generate write instructions and write data to initialize the data of DDR 
particles. After writing is full, test main ctrl starts to perform random Read and write, test rd ctrl 


checks the read-back data to determine whether the data is wrong 


Attention: 


The Example Design generated by IP cannot directly run the Flow on-board test. It is necessary 
to perform pin constraints according to the actual pin connection relationship of the single board, and 


then run the Flow on-board test. 


2.5 IP Intarface description 


This section introduces the HMIC S IP related interface description and sequence description. 


2.5.1 Controller Intarface description 
1. Global Interface 


Table 2-7 Global interface 


Port VO | Width pele Description 
Values 
clk I 1 - External clock input. 
rst_n I 1 Low level | External reset input. 
ddr zqcs reg |I 1 High level | DDR ZOCS (ZO calibration Short) command reguest. 
ddr zqcs ack |O |1 High level | DDR ZQCS (ZO calibration Short) command complete response. 


The initialization completion flag of ddrphy: 
phy. init done |I 1 High level | 1’b1: ddrphy initialization completed; 
1'b0: ddrphy initialization is not complete. 


IP initialization complete flag: 
1'bl: ddr IP initialization completed; 


Pup tendon: O. 14 aiii 1'b0: The ddr IP initialization is not completed, and the external 
operation on the ddr IP is invalid. 
Note: "-" indicates that there is no such parameter. 
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2. AXI4 Interface 
(1) Write Address Channel 


Table 2-8 Write address channel 


Port UO Width aes Description 

axi_awaddr I AXI ADDR WIDTH - AXI write address. 

axi awid I 8 - AXI write address ID. 

axi awsize I 3 - AXI write burst size. 

axi awburst I 2 - AXI write burst type. 

axi awlen I 8 - AXI write burst length. 

axi awready O 1 High level | AXI write address ready. 

axi awvalid I 1 High level | AXI write address valid. 
Note: "-" indicates that there is no such parameter. 


(2) Read Address Channel 


Table 2-9 Read address channel 


Port VO Width ae Description 
axi_araddr I AXI_ADDR_WIDTH - AXI read address. 
axi_arid I 8 - AXI read address ID. 
axi arsize I 3 - AXI read burst size. 
axi arburst I 2 - AXI read burst type. 
axi arlen I 8 - AXI read burst length. 
axi arready O 1 High level | AXI read address ready. 
axi arvalid I 1 High level | AXI read address valid. 
Note: "-" indicates that there is no such parameter. 


(3) Write Data Channel 


Table 2-10 Write data channel 


Port UO Width Mine Description 

axi wdata I AXI DATA WIDTH"8 - AXI write data. 

axi wstrb I AXI DATA WIDTH"8/8 | High level | AXI write data strobes. 

axi_wvalid I 1 AXI write data valid. 

axi_wready O 1 High level | AXI write data ready. 

axi bready I 1 High level | AXI writes the reply ready. 

axi bid O 8 - AXI write data ID. 

axi bresp O 2 - AXI writes the reply. 

axi bvalid O 1 AXI write reply valid. 
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Port VO Width vaud Description 
Values 
axi_wlast I 1 High level | AXI write data last. 


Note: "-" indicates that there is no such parameter. 


(4) Read Data Channel 


Table 2-11 Read data channel 


Port UO Width M Description 
Values 
axi rid O 8 - AXI read data ID. 
axi rlast O 1 High level | AXI read data last signal. 
axi rvalid O 1 High level | AXI read data valid. 
axi rdata O AXI DATA WIDTH"8 |- AXI read data. 
AXI read data ready. 
axi rready I 1 Note: axi rready needs to be pulled high 
when axi rvalid is valid. 
axi rresp O 2 AXI read reply. 
Note: "-" indicates that there is no such parameter. 


3. Config Interface 


Table 2-12 Config interface 


Port Vo Width Menai Description 
apb_clk I 1 High level | APB clock. 
apb_rst_n I 1 Low level | APB reset. 
apb_sel I 1 High level | APB Select. 
apb_enable I 1 High level | APB port enable. 
apb_addr I 8 - APB Address bus. 
apb_write I 1 High level | APB read and write direction, high level write, low level read. 
apb_ready O 1 High level. | APB port Ready. 
apb wdata I 16 - APB write data. 
apb_rdata O 16 - APB read data. 
Note: "-" indicates that there is no such parameter. 


4. DFI Interface 


Table 2-13 DFI interface 


Port UO Width vend Description 

Values 
dfi_address O |4*ROW_ADDR_WIDTH |- DFI address bus. 
dfi_bank O |4*BADDR_WIDTH - DFI bank. Address bus. 
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Port TO Width N Description 
dfi cs n O |4 - DFI chip select. 
dfi ras n O |4 - DFI row address strobe bus. 
dfi cas n O |4 - DFI column address strobe. 
dfi we n O |4 - DFI write enable signal. 
dfi cke O |4 - DFI clock enable. 
dfi odt O |4 - DFI on-die termination control bus. 
dfi rddata valid |I 1 High level | The read data valid of the dfi interface. 
dfi_rddata I DQ_WIDTH*8 - Data for the dfi interface. 
dfi_wrdata_en O |4 High level | DFI write enable signal. 
dfi wrdata O (|DO WIDTH"8 - DFI write data. 
dfi wrdata mask|O |DO WIDTH"8/8 High level | DFI Write data byte mask. 
dfi phyupd reg |I 1 - The PHY reguests an update. 
dü.phyupd ack |O' |1 | d pui: c sk EI allowing 


Note: "-" indicates that there is no such parameter. 


2.5.2 Controller Interface Timing Description 
The standard AXI4 protocol used by the AXI4 interface. The Config interface uses the APB 


protocol. 


1. AXI4 Inferface 

The AXI4 interface includes 4 channels, which are the write address channel, read address 
channel, write data channel, and read data channel, and each channel is independent of each other. 
Generally speaking, you need to send the address first, and then send and receive data. Users can judge 


whether the returned data is the reguested value through different id numbers. 


There are two correspondences between the AXI4 interface address and the Memory address, 
corresponding to the "Memory Address Mapping Selection" option area of the configuration interface. 
When "ROW+BANK+COLUMN" is selected, the corresponding relationship between AXI4 interface 
address and Memory address is shown in Figure 2-16; when "BANK+ROW+COLUMN'" is selected, 
the corresponding relationship between AXI4 interface address and Memory address is shown in 


Figure 2-17. 


MSB LSB 


Row Address Bank Address Column Address 


Figure 2-16 AXIA interface address mapping 1 
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MSB LSB 


Bank Address Row Address 


Column Address 


Figure 2-17 AXIA interface address mapping 2 
(1) Write address channel timing 


The signals included in the write address channel: axi awready, axi awvalid, axi awaddr, 


axi awsize, axi. awburst, axi, awid, axi awlen. Typical timing is shown in Figure 2-18. 


ck ELELE LF LMP LP LF LE LF LF OLE 
aiawaid of NS $ 

axi awready S S ZONE 
axi awaddr Kump 207  Y— — O 
aiawen EX sno X Sn NIN JIN STU — gem 
ax awd E cona X sto (i She $ "m 
axi awburst zni 0 Zhi N Zhi 

axiawsize am . CCC 


Figure 2-18 Typical Timing of Write Address 


€ One handshake completion condition: axi awready and axi awvalid are valid at the same 
time. 

€ The packet length is controlled by axi awlen, and the packet length is the value of axi awlen 
plus 1. 

e 


Handshaking process: starting from the rising edge of the axi awvalid valid clock, 


axi awaddr, axi awid, and axi awlen need to remain unchanged until the handshake is 


completed and released. 
(2) Read address channel timing 


The signals contained in the read address channel: axi arready, axi_arvalid, axi araddr, 


axi_arburst, axi arsize, axi arid, axi arlen. Typical timing is shown in Figure 2-19. 
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axi. araddr addrox addr [D$  — — | | 

aad — > Shi BHH OGEEEENWEND BHT 5 —— — — — — GENE 
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axi arburst 2ni v Zhi y 2ni 
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Figure 2-19 Typical Timing of Read Address 


€ = One handshake completion condition: axi, arready and axi_arvalid are valid at the same time. 


€ = The packet length is controlled by axi_arlen, and the packet length is the value of axi_arlen 


plus 1. 


€ Handshake process: starting from the rising edge of the axi. arvalid valid clock, axi araddr, 


axi arid, and axi arlen need to remain unchanged until the handshake is completed and 


released. 


(3) Write data channel timing 


The write data channel contains signals: axi wready, axi wvalid, axi bready, axi bid, axi bresp, 


axi bvalid, axi. wlast, axi wdata and axi, wstrb. Typical timing is shown in Figure 2-20. 


cik 


axi wready 
axi wlast 
axi wvalid 
axi wstrb 
axi wdata 
axi bready 
axi bid 

axi bresp 


axi bvalid 


FSS Sa R | 
EEE eC F*E IzvTv.v'v, z, vv, 


Figure 2-20 Typical timing sequence for writing data 


€ Transmission valid indication: axi wready is valid. 


€ Indication of the end of a transmission: axi. wlast is valid. 


€ During transmission: axi wready, axi bid and axi wlast are received synchronously, 


axi wdata and axi wstrb are sent synchronously. 
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(4) Read Data Channel Timing 


Read data channel Contains signals: axi rdata, axi rready, axi rresp, axi rid, axi rlast and 


axi rvalid. Typical timing is shown in Figure 2-21. 


ok FL AL FL FL FIN FL FL FL F— 


axi rvalid 


axi rlast S 


S 
A RHH Ha <8 G82 > 


axi rid > 517 


axi rdata EEC 0 Ce ae > a ca 


axi_rready YS S 


axi rresp NND TespU X Tesp1 resp? > E rep e resp NO esp «GEEK [OSP 


Figure 2-21 Typical timing seguence for reading data 


€ Transmission valid indication: axi rvalid is valid. 


€ Indication of the end of a transmission: axi rlast is valid. 


€ axi rready needs to be pulled high when axi rvalid is valid. 


2. Config Interface 

The Config interface adopts the standard APB protocol. By configuring the corresponding 
registers, DDR3/DDR4 SDRAM can be switched between Power Down, Self-Refresh, MRS and 
Normal states. By reading the corresponding register, the current state of DDR3/DDRA can be queried. 


The APB interface is a half-duplex communication, the read and write data lines are independent, 


and the control line and address line are multiplexed. Each handshake needs to consume at least 2 cycles 
of apb clk. 


The signals included in the APB interface: apb enable, apb ready, apb_rdata, apb sel, apb write, 
apb wdata, apb cik. 


A handshake completion condition: apb enable and apb ready are valid at the same time. 


(1) APB interface write timing 


The typical write sequence of APB interface is shown in Figure 2-22. 
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Figure 2-22 Typical write timing of APB interface 
€ = The first clock cycle: apb sel, apb write are pulled high, apb_addr, apb wdata are given 
initial values, they need to remain stable until they are released after the handshake is 


completed. 


€ The second clock cycle: apb enable is pulled high until the handshake is completed and 


released. 


(2) APB interface read timing 
The typical read timing of APB interface is shown in Figure 2-23. 


apok f 154515151515 Lf Lf Li Li Li 
absd | 8 yo: : TNI Fe ey tre NE 
apb_write (( N 

apb addr 8h2 8n | i> | 
apb rdata | aS ESSE | nei 16h? 
apb_enable [OTONA (( / iN 

apb ready S \ 


Figure 2-23 Typical read timing of APB interface 


€ The first clock cycle: apb sel is pulled high, apb write is pulled low, apb_addr is given the 


initial value, and they need to remain stable until the handshake is completed and released. 


€ The second clock cycle: apb enable is pulled high until the handshake is completed and 
released. 
€ Valid data: apb rdata is only valid during handshake. 
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(3) DDR3/DDR4 State switching and query methods 
In order to avoid the user's state switching request from interfering with the normal DDR3/DDR4 
timing, the user needs to follow certain operating rules when performing state switching (query the 
STATUS_REG_ADDR register to determine the current state of DDR3/DDR4 and whether the request 
has been responded; control the CTRL MODE DATA register to realize DDR3/DDRA state 


switching). 


€ When sending a new state switching request, you must first check whether the current state 


switching request has been responded, otherwise an error will result. 


€ The state switch request and the state switch trigger enable need to be sent synchronously, 


that is, bit 0 and bit[15:14] of CTRL MODE DATA need to be configured at the same time. 


€ When configuring the Mode Registers inside DDR, you need to configure the 
MODE_REG_0_ADDR, MODE_REG_1_ADDR, MODE_REG_2_ADDR, 
MODE REG 3 ADDR, MODE REG 4 ADDR, MODE REG 5 ADDR, 
MODE REG 6 ADDR registers first, and then configure CTRL MODE DATA register. 


€ After sending the state switching request, wait for 2 apb clks, and then check the relevant 


state register to see if it has responded. 


The state request switching process is shown in Figure 2-24, taking controlling DDR3/DDR4 to 


enter the Power Down state as an example. 
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STATUS REG. Stepl: Ouery whether the current state is responded 


A DDR[15] 


N 
V 
CTRL MODE ADDR:16hc0 Step2: Send new status reguest 
V 
Wait for 2 APB clock cycle Step3: Wait for 2 APB clock cycles 


Step4: Query whether the new state is responded 


STATUS_REG 
_ ADDR[15] 


N 


V 
Read STATUS REG. ADDR[I:0] Step5: The new request has responded, read the new status 


Figure 2-24 DDR3/DDR4 state request switching flow chart 


2.5.3 PHY interface description 


1. Clock and reset interface 


Table 2-14 Clock and Reset Interface 


Port VO Width va Description 

ref clk I 1 - External Reference Clock Input. 

ddr rstn I 1 - External reset input. 

pll lock O 1 High level | PLL lock indication, high level means locked. 

ddrphy cpd lock O 1 High level | cpd lock indication, high level means locked. 

ddrphy syselk o 1 l Kaz en nei Ni = PHY is output to the working 


Note: "-" indicates that there is no such parameter. 
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2. DFI Interface 


Table 2-15 DFI interface 


Port UO Width wali Description 
Values 
dfi_address I 4*ROW_ADDR_WIDTH |- DFI Address Bus. 
dfi_bank I 4*BADDR_WIDTH - DFI bank. Address Bus. 
dfi_reset_n I 1 - DFI chip reset. 
dfi_cs_n I 4 - DFI chip select. 
E 4"MEM BANKGROUP . 
dfi bg I WIDTH - DFI Bank Group (DDR4 only). 
dfi act n I 4 - DFI Activation Command (DDR4 only). 
dfi ras n I 4 - DFI row address strobe bus. (DDR3 only). 
dfi cas n I 4 - DFI column address strobe. (DDR3 only). 
dfi we n I 4 - DFI write enable signal. (DDR3 only). 
dfi cke I 4 - DFI clock enable. 
dfi odt I 4 - DFI on-die termination control bus. 
dfi rddata valid |O |1 High level | The read data of the dfi interface is valid. 
dfi rddata O (|DO WIDTH"8 - Data for the dfi interface. 
dfi wrdata en I 4 High level | DFI write enable signal. 
dfi wrdata I DO WIDTH"8 - DFI write data. 
dfi wrdata mask |I DQ WIDTH*8/8 High level | DFI Write data byte mask. 
dais complete KO: 1 HighrTevel The PHY has completed the training-related 
operations and is in the normal state. 
dfi error O |I High level | PHY training error indication. 
dfi phyupd reg |O |I - The PHY reguests an update. 
2 Feedback signal of dfi_phy_req, allowing 
dfi phyupd ack |I 1 - PHY to update. 
Note: "-" indicates that there is no such parameter. 
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The Memory interface in this IP is subject to the agreement. If the granule selected by the user 


includes an interface that is not included in the protocol, please refer to the corresponding granule 


Datasheet to add it yourself and handle it properly. 


Table 2-16 Memory interface 


Port VO | Width valid Description 
Values 
mem_a O |ROW ADDR WIDTH - DDR row and column address bus. 
mem ba O BANK ADDR WIDTH - DDR Bank address. 
mem ck O |l - DDR input system clock. 
mem ck n O |l - DDR input system clock. 
mem cke O |I High level | DDR input system clock is valid. 
mem dm O |DM WIDTH High level | DDR input data Mask. 
mem, odt O ! - DDR ODT. 
mem cs n O ! Low level | Chip select for DDR. 
mem ras n O | Low level | Row address enable (DDR3 only). 
mem casn |O | Low level | Column address enable (DDR3 only). 
mem wen JO | Low level | DDR write enable signal (DDR3 only). 
mem rst n O ! Low level |DDR reset. 
mem, dq I/O |DO WIDTH - DDR data. 
mem, dqs I/O |DOS WIDTH - DDR data-associated clock. 
mem dqs n |I/O DQS WIDTH - DDR data-associated clock. 
mem bg O |MEM BANKGROUP WIDTH |- DDR bank group (DDR4 only). 
mem act n O ! - DDR Activation Command (DDR4 only). 
mem parity |O l1 l DDR Command and Address Parity 
(DDR4 only). 
mem_alert_n JI MEM, ALERT ADDRESS - Memory error flag (DDR4 only). 
Note: "-" indicates that there is no such parameter. 
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4. Debug Interface 


Description: 
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For the specific usage of the debugging interface, please refer to "UGO50010 Titan2 Series 
HMIC S IP Application Guide" [12]. 


Table 2-17 Debug Interface 


Port 


UO 


Width 


Description 


Manually debug input signals 


debug gate start 


Reset seguence control, valid on rising edge. 


debug cpd start 


Reset seguence control, valid on rising edge. 


debug_ddrphy_rst_n 


Reset sequence control, active low. 


debug gpll scan rst 


Reset seguence control, active high. 


debug dll update en 


dll update enable signal 


init wrlvl step 


8*DQS WIDTH 


The initial step of dqs when doing Write leveling. There 
are DOS WIDTH groups, each group is 8bit, and each 
group can be configured independently. 


init slip step 


4*DQS WI DTH 


The initial value of dqs gate coarse tuning position. 
There are a total of DOS WIDTH groups, each group is 
4bit, and each group can be configured independently. 


init read clk ctrl 


3*DOS WIDTH 


The initial value of dqs gate fine-tuning position. 
There are a total of DOS WIDTH groups, each group is 
3bit, and each group can be configured independently. 


ck dly set bin 


The CK signal output delay adjustment port of the 
memory interface. 

The port configuration value is multiplied by 5ps, which 
is the additional delay value of CK, which is calculated 
based on the demo board routing delay. The additional 
delay value of CK is preferably in the range of 
50-150ps. 


dqs even adj 


Read direction dgs rising edge delay adjusts the port. 
bit7 is the sign bit, 1 means decrease delay, 0 means 
increase delay. 

The bit6-0 configuration value is multiplied by 5ps, 
which is the additional delay value added on the rising 
edge of dqs. 


dos. odd adj 


Read direction dgs falling edge delay adjusts the port. 
bit7 is the sign bit, | means decrease delay, 0 means 
increase delay. 

Multiplying the bit6-0 configuration value by 5ps is the 
additional delay value added on the falling edge of dgs. 
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Port UO Width Description 
The dgs gate position is fixed and enabled, and the 
high level is effective. 
force_read_clk_ctrl I 1 0: The dqs gate position changes during training. 
1: The position of the dqs gate remains unchanged and 
is always the initial value. 
IOB output impedance calibration value input, pcode, 
rescal pcodel bank0-2 |I 5 the first set of values, bank0-3 correspond to bank R5, 
R6 or R7. 
IOB output impedance calibration value input, ncode, 
rescal ncodel bank0-2 |I 5 the first set of values, bank0-3 correspond to bank R5, 
R6 or R7. 
IOB output impedance calibration value input, pcode, 
rescal pcode2 bank0-2 |I 5 the second set of values, bank0-3 correspond to bank 
R5, R6 or R7. 
IOB output impedance calibration value input, ncode, 
rescal ncode2 bank0-2 |I 5 the second set of values, bank0-3 correspond to bank 
R5, R6 or R7. 
rescal training reset enable, active high. 
rescal rst I 1 eh 
Reset once to start training once. 
gate update en I 1 dgs gate update enable, active high. 
dbg manu gate upd en |I 1 dgs gate update manual control enable, active high. 
BE Ji 1 das gate update Manual control starts, the rising edge 
is valid. 
MEM BANKADDR . i x 
upd act ba I WIDTH Active bank during dqs gate update. 
MEM BANKGROUP ; l) : 
upd act bg I WIDTH Active group during dqs gate update. 
Gate result judgment signal selection during dqs gate 
gate dqs sample sel I 1 update: 
0: select dqs gate sample; 1: select ddrphy dgts; 
dqs gate update 16 samples left to adjust the decision 
threshold. 
left err sure num I 5 When the number of errors is greater than or equal to 
the threshold, it is judged as error, otherwise it is 
judged as correct. 
dqs gate update 16 samples right to adjust the decision 
threshold. 
right err sure num I 5 When the number of errors is greater than or equal to 
the threshold, it is judged as error, otherwise it is 
judged as correct. 
debug cpd offset adj I 1 cpd phase adjustment enable, rising edge is valid. 
cpd phase adjustment direction. 
debug cpd offset dir I 1 0: GPLL clock phase shifted right. 
1: Shift the GPLL clock phase to the left. 
force idv I 1 write leveling manual configuration enable, active 
high. 
force stel qs I 8*MEM_DQS_ write leveling configuration value. 
= -Step WIDTH Force_wrlvl is valid when high level. 
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Port TO | Width Description 
force_dqsgate I 1 dgs gate manual configuration enable, active high. 
Configuration value for dgs gate fine-tuning 
force read clk ctrl I 3"MEM DOS WIDTH location. 
Force dgsgate is valid when high. 
Configuration value for dgs gate coarse tuning 
force slip step I 4"MEM DOS WIDTH _| position. 
Force dgsgate is valid when high. 
force vret I 1 Read vref Manual configuration enable, active 
high. 
Read vref to manually configure range settings. 
force rdvref range I 1 0: rangel; 1: range2; force rdvref is valid when 
high level. 
Read vref to manually configure the value. 
sk 
feine tivna. value | SMEM BUS VDIH Force rdvref is valid when high level. 
Read calibration manual configuration enable, 
force rdcal I 1 : à 
active high. 
Read dq calibration manual configuration value. 
k * 
force rd da, dy l PI MEME DOS WIDTH Force_rdcal is valid when high level. 
Read dqs Calibration rising edge manual 
force_dqs_even_dly I 8"MEM DOS WIDTH configuration value. 
Force rdcal is valid when high level. 
Read dqs Calibration falling edge manual 
force dqs odd dly I 8"MEM DOS WIDTH configuration value. 
Force rdcal is valid when high level. 
; Read dbi calibration manual configuration value. 
" sk 
force ni dbi. aly l STET Force rdcal is valid when high level. 
Write vref calibration manual configuration 
force wrvref I 1 l ; 
enable, active high. 
Write vref to manually configure range settings. 
force wrvref range I 1 0: rangel; 1: range2; force wrvref is valid when 
high level. 
Raa — valie I 6 Write vref to manually configure the value. 
— = Force_wrvref is valid when high level. 
Write calibration manual configuration enable, 
force_wrcal I 1 : : 
active high. 
Write dq to calibrate manual configuration values. 
sk 
force wr. dg dly I BEMEM DOS VIRIH Force wrcal is valid when high level. 
Write data mask(dbi) to manually configure the 
force wrdm dbi dly I 8"MEM DOS WIDTH value. 
Force wrcalis valid when high level. 
Wr Win scan en I 1 Write scan window enable, active high. 
opm Sun SEEN IT MEM. DOS WIDTH Write sweep window group enable, active high. 
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Port TO | Width Description 
rd_win_scan_en I 1 Read sweep window enable, active high. 
rd win scan grovp.en [I [MEM_DQS_WIDTH JAM enis valid when high evel, 

Read direction group alignment error latch 
align_error_clr I 1 clear signal, the rising edge clears 

align error lck. 

Common Debug Output Signals 

Debug data 
debug. data? O 166*DQS WIDTH DL o m Debug data, 8bit 
debug_calib_ctrl? O |36 Debug data in Tainning state. 
debug slice status? O |17*MEM DOS WIDTH | | Training status. 
debug slice state!! O |22"MEM DOS WIDTH | | Training status. 
Other 
debug dll upd state O 2 dll update controls the state. 
debug gpll dps phase O J9 gpll current phase. 
debug_rst_state O |4 Reset seguence state. 
debug eye dg win O |72*MEM DOS WIDTH Eye calibration dq window. 
debug dq dly bin O |64"MEM DOS WIDTH dq delay binary code. 
debug eye dm win O (|9"MEM D QS WIDTH-1 |Eye calibration dm window. 
debug dm dly bin O /|8*MEM. DOS WIDTH dm delay binary code. 
debug rd dq dly bin O |64"MEM DOS WIDTH Read direction dq delay binary code. 
debug rd dbi dly bin O /|8*MEM. DOS WIDTH Read direction dbi delay binary code. 
debug rdvref margin win |O |7*MEM DQS WIDTH Read vref Calibration window. 
debug rdvref left edge O /|6*MEM DOS WIDTH Read vref to calibrate the left margin. 
debug rdvref mode O /|6*MEM D Read vref calibration value. 


S debug. data See "2.5.5 1 debug. data description" for the meaning description of each field. 

? debug calib ctrl See "2.5.5 2 debug calib ctrl description" for the meaning description of each field. 

10 debug slice status See "2.5.5 3 debug. slice status description" for the meaning description of each field. 
! debug slice state See "2.5.5 4 debug slice state description" for the meaning description of each field. 
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Port 


TO 


Width 


Description 


QS_WIDTH 


pcode_out 


30 


IOB output impedance calibration 
value output: 

bit[29:25]: pcode odd of bank2; 
bit[24:20]: pcode even of bank2; 
bit[19:15]: pcode odd of bankl; 
bit[14:10]: pcode odd of bank) pcode 
even of bankl; 

bit[9:5]: pcode odd of banko; 
bit[4:0]: pcode even of banko. 


ncode out 


30 


IOB output impedance calibration 
value output: 

bit[29:25]: ncode odd of bank2; 
bit[24:20]: ncode even of bank2; 
bit[19:15]: ncode odd of bank1; 
bit[14:10]: ncode odd of bank1 ncode 
even of bankl; 

bit[9:5]: ncode odd of banko; 
bit[4:0]: ncode even of banko. 


ddrphy update done 


dgs gate update completion indication: 
1: update completed; 
0: update not completed; 


dos. drift 


2*MEM DQS WIDTH 


dqs Drift indicator signal. 


dbg dram vref left edge phyO 


6 


dram vref calibrates the left boundary 
value. 


dbg dram vref margin win, phyO 


7 


dram vref Calibration window value. 


dbg dram vref range 


dram vref calibration range. 


dbg dram vref value phyO 


dram vref calibration value. 


dbg update done 


O oco oo o 


dqs gate update completion indication 
signal, active high. 


left sample error 


16*MEM DQS WIDTH 


dqs gate update 16 left-adjusted 
sampling results. 


right sample error 


16*MEM DQS WIDTH 


dqs gate update 16 times to right 
adjust the sampling result. 


left sample err sure 


MEM DQS WIDTH 


dqs gate update 16 samples to left 
adjust the decision result. 


right sample err sure 


MEM DQS WIDTH 


dqs gate update 16 samples to right 
adjust the decision result. 


left adj cnt 


8*MEM DQS WIDTH 


dqs gate update adjusts count left after 
multiple verdicts. 


right adj cnt 


8*MEM DQS WIDTH 


dqs gate update adjusts the count to 
the right after multiple judgments. 


no adj cnt 


8*MEM DQS WIDTH 


dqs gate update does not adjust the 
count after multiple judgments. 


UG052001 


www.pangomicro.com 


49/77 


[n] si LTH ZS Y ol OU 2 OR LO] 


SHENZHEN PANGO MICROSYSTEMS CO.LTD 


Port 


T/O 


Width 


Description 


debug_cpd_offset 


10 


cpd Phase adjustment value. 


debug_cpd_state 


4 


cpd phasing status. 


align_error 


Read direction group data alignment error signal: 
0: group data alignment is correct; 

1: group data alignment error; 

This signal is a dynamic signal. 


align_error_lck 


Read direction group data alignment error latch signal: 
0: group data alignment is correct; 

1: group data alignment error; 

This signal is the latch signal of align_error, 

A rising edge on align_error_clr clears this signal. 


Attention 


After the Training is completed, the user can treat all Debug ports as asynchronous signals, and 
optimize the timing by setting False Path if necessary. Among them, the signal values of 


coarse slip step and read clk ctrl can only be read when dfi_phyupd_ack is pulled low, otherwise their 


signal values may change during gate update, resulting in inaccurate data reading. 


2.5.4 PHY Interface Timing Description 


1. DFI Interface Specification 


When the user directly accesses the PHY Layer, it needs to comply with the DFI-like interface 


specification defined in this article. Through this interface, users can perform the following operations. 


€ = Access (read/write) DDR SDRAM; 


€ Put DDR3 into Power Down or Self-Refresh state; 


€ Dynamically configure the value of DDR SDRAM internal registers; 


Chapter 2 IP Usage Guidelines 


€ Read the status of DDR SDRAM. 


For the differences between the DFI interface used in this design and the standard DFI 3.1 


Specification[11], see Table 2-18 and Table 2-19. 
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Table 2-18 Differences between the DFI interface of this design and the standard DFI 


Interface 


Difference 


ControlInterface 


No requirement for tctrl. delay and temd lat. 


Write Datalnterface 


Compatible with standard DFI except the dfi wrdata cs n signal. 


Read Datalnterface 


Only the dfi rddata and dfi rddata valid signals are kept. 


Updatelnterface Adopt a custom interface. 
StatusInterface Only dfi_init_complete is left. 
TrainingInterface NA. 

Low PowerControlInterface |NA. 

ErrorInterface Compatible. 


Table 2-19 Detailed difference comparison between DFI interface and standard DFI 


Interface 
Signal Standard DFI  |Simplified DFI |Source |Description 
Class 
dfi act n dfi act n MC DFI Activation Command (DDR4 only) 
dfi address dfi, address MC DFI address bus 
dfi bank dfi bank MC DFI bank address bus 
dfi bg dfi bg MC DFI Bank Group (DDR4 only) 
dfi cas n dfi cas n MC DFI column address strobe (DDR3 only) 
Control dfi cid NA MC DFI Chip ID 
signals — |gfi cke dfi cke MC DFI clock enable 
dfi cs n dfi cs n MC DFI chip select 
dfi odt dfi, odt MC DFI on-die termination control bus 
dif ras n dif ras n MC DFI row address strobe bus (DDR3 only) 
dfi reset n dfi reset n MC DFI chip reset 
dfi we n dfi we n MC DFI write enable signal (DDR3 only) 
dfi wrdata dfi wrdata MC DFI write data 
Write dfi wrdata cs n |NA MC DFI Write Data Chip Select 
Seu dfi wrdata en dfi wrdata en MC DFI write enable signal 
dfi wrdata mask |dfi wrdata mask | MC DFI Write data byte mask 
dfi rddata dfi rddata PHY dfi interface data 
Read Data | dfi rddata cs n. |NA MC DFI Read Data Chip Select 
Signals — |dfi rdata dbi n |NA PHY |Read Data DBI 
dfi rddata en NA MC Read data enable 
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Interface 
Signal Standard DFI Simplified DFI | Source | Description 
Class 
dfi_rddata_valid dfi_rddata_valid |PHY |The read data of the dfi interface is valid 
dfi_rddata_dnv NA PHY _ | DFI data not valid 
dfi_ctrlupd_ack NA PHY | MC-initiated update acknowledge 
dfi_ctrlupd_req NA MC MC- initiated update request 
"a UI dfi phyupd ack dfi phyupd ack |MC PHY-initiated update acknowledge 
dfi_phyupd_req dfi_phyupd_req |PHY  |PHY-initiated update request 
dfi_phyupd_type NA PHY | PHY-initiated update select 
dfi_alert_n NA PHY |CRC or parity error indicator 
dfi_data_byte_disable NA MC Data byte disable 
dfi_dram_clk_disable NA MC DRAM clock disable 
Status dfi_freq_ratio NA MC DFI frequency ratio indicator 
Signals dfi_init_complete dfi init complete |PHY | PHY initialization complete 
dfi_init_start NA MC SE Ne stabilization or freguency change 
dfi parity in NA MC Parity value 
dfi calvl capture NA MC CA training capture 
dfi phy calvl cs n NA PHY  |CA training chip select 
dfi calvl en NA MC PHY CA training logic enable 
dfi calvl req NA PHY  |PHY-initiated CA training request 
dfi calvl resp NA PHY  |CA training response 
dfi lvl pattern NA MC Training pattern 
dfi lvl periodic NA MC Training length indicator (full or periodic) 
dfi phylvl ack cs n NA MC DFI PHY training chip select acknowledge 
dfi phylvl req cs n NA PHY || DFI PHY training chip select request 
e di gis divi gcn NA PHY ien iiie chip select for read data eye 
Signals — |gfi phy rdlvl gate cs n |NA PHY  |Read training chip select for gate training 
dfi phy. wrlvl cs n NA PHY | Write leveling chip select 
dfi rdlvl en NA MC PHY read data eye training logic enable 
dfi rdlvl gate en NA MC PHY gate training logic enable 
dfi rdlvl gate req NA PHY  |PHY-initiated gate training request 
dfi rdlvl req NA PHY  |PHY-initiated read data eye training request 
dfi rdlvl resp NA PHY |Read training response 
dfi wrlvl en NA MC PHY write leveling logic enable 
dfi wrlvl reg NA PHY | PHY write leveling request 
dfi_wrlvl_resp NA PHY | Write leveling response 
dfi_wrlvl_strobe NA MC Write leveling strobe 
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Interface 
Signal Standard DFI Simplified DFI | Source | Description 
Class 

dfi Ip. ack NA PHY  |Low power acknowledge 
Low 
Power dfi lp ctrl req NA MC Low power opportunity control request 
zena dfi Ip. data reg NA MC Low power opportunity data request 

ignals 

dfi lp wakeup NA MC Low power wakeup time 
Error dif error dif error PHY  |DFIError 
Signals — dfi error info NA PHY  |DFI Error Info 


2. DFI Interface Timing 

The working clock frequency ratio of MC and PHY is 1:4, that is, each MC command corresponds 
to 4 Phase PHY commands. Instructions and data can be distributed among the 4 Phases of the PHY 
according to requirements. When users send control commands on the DFI interface, they must strictly 
follow the requirements of DDR SDRAM on command and data delays. DFI commands can only be 


received after dfi init complete is pulled high, and the PHY aligns the data of the read operation. 


(1) DFI Interface WriteTiming 
To write data to DDR3 SDRAM, you need to send the write command first, and then send the 


data. The typical timing is shown in Figure 2-25. 


€ Write operation control: dfi cs. n, dfi ras n, dfi cas n, dfi we n, dfi cke, dfi odt. 


€ Address line for write operation: dfi bank, dfi address. 


€ Data lines for write operations: dfi wrdata en, dfi wrdata, dfi wrdata mask 


(2) DFI Interface Read Timing 
To read data from DDR3 SDRAM, you need to send the read command first, and then receive the 
data returned by PHY through DFI. The typical timing is shown in Figure 2-26. 


€ Control lines for read operations: dfi cs n, dfi ras n, dfi cas n, dfi we n, dfi cke, dfi odt 


€ Address lines for read operations: dfi bank, dfi address. 


€ Data lines for read operations: dfi rddata, dfi rddata valid. 
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Figure 2-25 DFI interface write operation sequence 


Note: This timing diagram is the simulation timing diagram when WL-9. 
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di ck Fra STI HOT dl t HE FILE 
dfi es n Lm k m K Ee o o od ee 
dii ras n ERE DEM, DEA SO IRENE SEEPS SS | (SSS OO, | O Se 
dfi_cas_n "m XY m X [Hi Ini 

dfi we n Jm COME | | - 
dfi bank SD =D, OYO H —— — —————— —— 
dfi address —— emn MET o 1 o o o 
dfi_rddata iHi ul X rddatao X 
` Wi ‘a? 
merek FLELELELFLELELELELELELFLFLFLFLELELELELELELFELELE LE LLLP $e 
command E) CE G) Kf ——— 
mem cs n VN CÓ y 
| TANJI] AM 
L1 —  —— ———  "]—— 1 ——— —1 ———G 
NEM ——h n 
mem ba SOSIČ T 1 pg pa o po 
mem a —2 ZZ ZZ ZZ ZZ ZZ ZZ ZZ ZZ ZZZZE—OAaKKasIH — —AM—— 
mem das i; Hi AAVV H 
mem dq i HI Q0000000—Hl 


RL = AL + CL 


dfi_rddata_valid HI 


Figure 2-26 DFI interface read operation sequence 


Note: This timing diagram is a simulation timing diagram, and Trd is 7 dfi clk cycles. In fact, the board timing is different from the above diagram. 
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2.5.5 Debug Data description 
1. debug_data description 
For the description of each field of debug_data, see Table 2-20. 


Table 2-20 Definition of each field of debug_data 


Bits Corresponding Debug port |Description 

3:0 coarse_slip_step Coarse adjustment position obtained by dqs gate training 

6:4 read_clk_ctrl The fine-tuned position obtained by dgs gate training 

10:7 gate_win_size The number of valid windows for dqs gate training 

11 pate cheek pats dgs gate training completion indication (will be set to 0 after 
completion) 

12 sddub sha aks Read the calibration data to confirm the completion indication (it 
will be set to 0 after completion) 

2019 | desveven bin Read the dqs rising edge delay step value obtained after the eye 
diagram calibration is completed 

28:21 |dqs odd bin Read the das falling edge delay step value obtained after the eye 
diagram calibration is completed 

36:29 |total margin even margin of dgs rising edge window 

45:38 total margin odd margin of dqs falling edge window 

55:48 |wrlvl step The dqs delay step obtained when write leveling is completed 
Write direction write leveling delay step plus 90 degree code 

56 icone overflow flag 

sie 1: overflow 

0 does not overflow 

57 wrlvl dg The dg value returned when writing leveling 

65:58 |wl p dll bin write leveling delay code plus 90 degree code 


2. debug calib ctrl description 


For the description of each field of debug calib ctrl, see Table 2-21. 


Table 2-21 Definition of each field of debug calib ctrl 


Bits Corresponding Debug port | Description 

0 Calib;sébir training error indication (generated by write leveling read calibration 
error) 

4:1 dbg upcal update control state machine 

9:5 dbg_eyecal Reading Eye Diagram Calibration Control State Machine 

14:10 |dbg_wrcal Write Calibration Control State Machine 

18:15 |dbg_rdcal MPR Read Calibration Control State Machine 

22:19 | dbg_wrlvl write leveling calibration control state machine 

26:23 | dbg_init Power-on initialization process control state machine 

30:27 |dbg main training main state machine 

34:31 |error_status training error status record: 
0: training is correct 
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Bits 


Corresponding Debug port 


Description 


NO Oda RV ND 5 


: write leveling training error 

: dqs gate training error 

: read vref training error type 1 

: read vref training error type 2 

: read training error 

: write vref training error 

: write training error 

: data mask (write dbi) training error 
: read vref fine training error 


10: read dbi training error 
11: eye read training error 
12: eye write training error 


The PHY that is being trained at the time of training error 
When instantiated as Ping-Pong PHY: 


35 phy. 1 calib en 0: training PHYO 


1: training PHY1 


Always 0 when instantiated as a single PHY 


3. debug_slice_status description 


For the description of each field of debug_slice_status, see Table 2-22. 


Table 2-22 Definition of each field of debug_slice_status 


Bits Corresponding Debug port |Description 


1:0 dll update code done tmp  |high group 
1: Done 
0: not completed 


dll update complete indication signal 
Each bit corresponds to a group, and the high bit corresponds to the 


dll lock indication 


11:10 |dil lock tmp 1: locked 


0: unlocked 


Each bit corresponds to a group (high bit corresponds to high group) 


13:12 |dgs gate comp done tmp group) 
1: Done 
0: not completed 


dqs gate update complete indication signal 
Each bit corresponds to a group (a high bit corresponds to a high 


17:16 !gate cal error tmp group) 
1: dqs gate error 
0: dqs gate no error 


dqs gate error indication signal 
Each bit corresponds to a group (a high bit corresponds to a high 
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Bits Corresponding Debug port |Description 


dgs gate complete indication signal 

Each bit corresponds to a group (a high bit corresponds to a high 
21:20 | gate_check_pass_tm p group) 

1: dqs gate completed 

0: dgs gate not completed 


Read calibration single delay adjustment complete indication signal 
Each bit corresponds to a group (a high bit corresponds to a high 
23:22 |rdel move done dsli ce group) 

1: Adjustment completed 

0: adjustment not completed 


Read calibration error indication signal 

Each bit corresponds to a group (high bit corresponds to high group) 
1: Calibration error 

0: no error 


25:24 |rdel calib error dsli ce 


Read calibration complete indication signal 

Each bit corresponds to a group (a high bit corresponds to a high 
27:26 |rdel calib done dsli ce group) 

1: Calibration completed 

0: not completed 


write leveling calibration complete indication signal 

Each bit corresponds to a group (a high bit corresponds to a high 
31:30 |wrlvl dgs resp tmp group) 

1: Calibration completed 

0: not completed 


write leveling calibration error indication signal 

Each bit corresponds to a group (high bit corresponds to high group) 
1: Calibration error 

0: no error 


33:32 |wrlvl error tmp 


4. debug slice state description 


For the description of each field of debug slice state, see Table 2-23. 


Table 2-23 Definition of each field of debug slice state 


Bits Corresponding Debug port Description 


7:0 dbg slice, rdehk state Read Calibration Data Compare State Machine Status Output 
11:8 dbg slice rpbd ctrl state Read Calibration Control dqs Delayed State Machine Status Output 
14:12 |dbg slice gate state Adjust the state output of the dqs gate delay state machine 


18:15 (|dbg slice dg wrcal state[3:0] | Control write direction dg delay state machine state output 


21:19 (|dbg slice wrlvl state Control write leveling delay state machine state output 
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Chapter 2 IP Usage Guidelines 


This section introduces the description and access methods of HMIC S IP related registers. 


2.6.1 Register description 


1. Controller Internal register 

(1) MODE REG 0 ADDR 
The definition of this register in DDR3/DDR4 mode is the same as MRO in DDR3 SDRAM 

Standard[9]/DDR4 SDRAM Standard[10], the bit width is 16bit, and the access address is 0x00. 


Table 2-24 Bit definition of DDR3 MODE_REG_0_ADDR 


Bits |Name Reset value Access type Description 
1:0 BL 2'b00 R Burst Length 
2 CL[0] Instantiated value | R/W CAS Latency (CL Oth bit) 
3 RBT Instantiated value | R/W Read Burst Type 
6:4 CL[3:1] |Instantiated value | R/W CAS Latency (CL [3:1] bit) CL max is 8 
7 TM 1’b0 R Mode 
8 DLL 0 R DLL Reset 
11:9 | WR Instantiated value | R/W Write recovery for autoprecharge 
12 PPD 1 R DLL Control for Precharge PD 
15:13 |Reserve |0 R Reserve 
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Table 2-25 Bit definition of DDR4 MODE REG 0 ADDR 


Bits |Name Reset value Access type | Description 

1:0 BL 2'b00 R Burst Length 

2 CL[0] Instantiated value | R/W CAS Latency (CL Oth bit) 

3 RBT Instantiated value | R/W Read Burst Type 

6:4 CL[3:1] Instantiated value | R/W CAS Latency (CL [3:1] bit) CL max is 8 

7 TM 1'b0 R Mode 

8 DLL 0 R DLL Reset 

11:9 |WR RTP |Instantiated value | R/W no 3 Rud Resets Pipe Sor auto 
15:12 | Reserve 0 R Reserve 


(2) MODE REG 1 ADDR 
The definition of this register in DDR3/DDR4 mode is the same as MRI in DDR3 SDRAM 
Standard[9]/DDR4 SDRAM Standard[10], the bit width is 16bit, and the access address is 0x01. 


Table 2-26 Bit definition of DDR3 MODE REG 1 ADDR 


Bits Name Reset value Access type | Description 

0 DLL 1'b0 R DLL Enable 

1 D.I.C[0] INS R/W Output Driver Impedance Control (D.I.C bit 0) 
2 Rtt Nom[0] |Instantiated value | R/W Rtt Nom bit 0 

4:3 AL 2’b10 R Additive Latency 

5 D.I.C[1] Instantiated value | R/W Output Driver Impedance Control (D.I.C bit 1) 
6 Rtt_Nom[1] | 1’b0 R/W Rtt Nom Ist bit 

7 Level INS R Write leveling enable" 

8 Reserve 1'b0 R Reserve 

9 Rtt Nom[2] | Instantiated value | R/W Rtt Nom bit 2 

10 Reserve 1'b0 R Reserve 

11 TDOS 1'b0 R TDOS enable 

12 Qoff 1'b0 R Qoff 

15:13 | Reserve 3'b000 R Reserve 


? See DDR3 SDRAM Standard[9] for details. 
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Table 2-27 Bit definition of DDR4 MODE REG 61 ADDR 


Bits Name Reset value Access type | Description 

0 DLL 1'b0 R DLL Enable 

2:1 D.I.C 2’b0 R/W Output Driver Impedance Control 
4:3 AL 2'b00 R Additive Latency 

6:5 Reserve 2'b0 R Reserve 

7 Level INS R Write leveling enable? 

10:8 Rtt_Nom Instantiated value | R/W Rtt_Nom 

11 TDQS 1'b0 R TDOS enable 

12 Qoff 1'b0 R Qoff 

15:13 Reserve 3'b000 R Reserve 


(3) MODE REG 2 ADDR 
The definition of this register in DDR3/DDR4 mode is the same as MR2 in DDR3 SDRAM 
Standard[9]/DDR4 SDRAM Standard[10], the bit width is 16bit, and the access address is 0x02. 


Table 2-28 Bit definition of DDR3 MODE REG 2 ADDR 


Bits Name Reset value Access type | Description 
2:0 PASR 3’b0 R Partial Array Self-Refresh (Optional) 
5:3 CWL Instantiated value | R/W CAS write Latency 
6 ASR 1'b0 R Auto Self-Refresh 
7 SRT 1'b0 R Self-Refresh Temperature Rang 
8 Reserve 1'b0 R Reserve 
10:9 Rtt WR 2'b00 R/W Rtt WR 
15:11 Reserve 5°b0 R Reserve 
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Table 2-29 Bit definition of DDR4 MODE REG 2 ADDR 


Bits Name Reset value Access type | Description 

2:0 Reserve 3'b0 R Reserve 

5:3 CWL Instantiated value | R/W CAS write Latency 

7:6 LP ASR 1'b0 R LoW Auto Self-Refresh 

7 SRT 1'b0 R Self-Refresh Temperature Rang 
8 Reserve 1'b0 R Reserve 

10:9 Rtt WR 2'b00 R/W Rtt WR 

11 Reserve 1'b0 R Reserve 

12 WCRC 1'b0 R Write CRC 

15:11 Reserve 5"b0 R Reserve 


(4) MODE REG 3 ADDR 
The definition of this register in DDR3/DDR4 mode is the same as MR3 in DDR3 SDRAM 
Standard[9]/DDR4 SDRAM Standard[10], the bit width is 16bit, and the access address is 0x03. 


Table 2-30 Bit definition of DDR3 MODE REG 3 ADDR 


Bits Name Reset value Access type | Description 
[15:0] | Reserve 16'h0 R Reserve? 

Table 2-31 Bit definition of DDR4 MODE REG 3 ADDR 
Bits Name Reset value | Access type | Description 
1:0 MPR PA 2’b0 R/W MPR page Selection 
2 MPR_OP 1'b0 R/W MPR Operation 
3 GM 1'b0 R/W Geardown Mode 
4 PDA 1'b0 R/W Per DRAM Addressability 
2 TSR 1'b0 R/W Temperature sensor readout 
8:6 FGRM 3’b0 R/W Fine Granularity Refresh Mode 
10:9 WCLCD 2'b00 R/W Write CMD Latency when CRC and DM are enabled 
12:11 MPR RF 2'b00 R/W MPR Read Format 
15:13 Reserve 3'b0 R Reserve 


13 See DDR3 SDRAM Standard[9] for details 


UG052001 


www.pangomicro.com 


62/77 


[1h s UJETI SE CI OU ERI 2 IR LG] 


SHENZHEN PANGO MICROSYSTEMS CO.LTD Chapter 2 IP Usage Guidelines 


(5) MODE REG 4 ADDR 
This register is only used in DDR4 mode, and its definition is the same as MR4 in DDR4 
SDRAM Standard[10], the bit width is 16bit, and the access address is 0x04. 


Table 2-32 Bit definition of DDR4 MODE REG 4 ADDR 


Bits Name Reset value | Access type | Description 

0 Reserve 1'b0 R Reserve 

1 MAX PDM | 1’b0 R/W Maximum Power Down Mode 

2 TCRR 1'b0 R/W Temperature Controlled Refresh Range 
3 TCRM 1'b0 R/W Temperature Controlled Refresh Mode 
4 IVM 1'b0 R/W Internal Vref Monitor 

5 Reserve 1'b0 R Reserve 

8:6 CCLM 3’b0 R/W CS to CMD/ADDR Latency Mode (cycles) 
9 SRA 1'b0 R/W Self Refresh Abort 

10 RPTM 1'b0 R/W Read Preamble Training Mode 

11 RP 1'b0 R/W Read Preamble 

12 WP 1'b0 R/W Write Preamble 

15:13 Reserve 3'b0 R Reserve 


(6) MODE REG 5 ADDR 
This register is only used in DDR4 mode, and its definition is the same as MR5 in DDR4 
SDRAM Standard[10], the bit width is 16bit, and the access address is 0x05. 


Table 2-33 Bit definition of DDR4 MODE REG 5 ADDR 


Bits Name Reset value | Access type | Description 

2:0 CPLM 3’b0 R/W C/A Parity Latency Mode 
3 CEC 1'b0 R/W CRC Error Clear 

4 CPES 1'b0 R/W C/A Parity Error Status 

5 ODT IB 1'b0 R/W ODT Input Buffer during Power Down mode 
8:6 RTT PARK | 1’b0 R/W RTT PARK 

9 CAPE 1'b0 R CA parity Persistent Error 
10 DM 1'b0 R/W Data Mask 

11 WDBI 1'b0 R/W Write DBI 

12 RDBI 1'b0 R/W Read DBI 

15:13 Reserve 3'b0 R Reserve 
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This register is only used in DDR4 mode, its definition is the same as MR6 in DDR4 SDRAM 
Standard[10], the bit width is 16bit, and the access address is 0x06. 


Table 2-34 Bit definition of DDR4 MODE REG 6 ADDR 


Bits Name Reset value | Access type | Description 

5:0 VREFTV 6’b0 R/W VrefDQ Training Value 

6 VREFTR 1'b0 R/W VrefDO Training Range 
7 VREFTE 1'b0 R/W VrefDO Training Enable 
9:8 Reserve 3’b0 R Reserve 

12:10 CCD_L 3'b0 R/W tCCD L 

15:13 Reserve 3’b0 R Reserve 


(8) CTRL MODE DATA 


This register is used to store the instruction (MRS/Low Power/Normal) issued by the user, and 


the access address is 0x04. See Table 2-35 for the definition of each bit. 


Table 2-35 Bit definitions of CTRL MODE DATA 


Bits Name Reset value | Access type | Description 
0 enable 1’b0 R/W ddr core state switching trigger enable 
13:1 Reserve 13'h0 R Reserve 
DDR Core state selection 
00: Normal 
15:14 select 2'b00 R/W 01: MRS 
10: Self-Refresh 
11: Power Down 
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(9) STATUS REG DATA 
This register is used to store the current state of DDR, and the access address is 0x05. For the 


definition of each bit, see Table 2-36. 


Table 2-36 Bit definitions of STATUS REG DATA 


Bits 


Name 


Reset value 


Aecess type 


Description 


mode state 


2'b0 


Store the current state of DDR3/DDR4 
2’b00: Normal State 

2’b01: Self-Refresh State 

2'b10: Power Down State 

2’b11:MRS State 


14:2 


Reserve 


13°b0 


Reserve 


busy 


1’b0 


Whether the current request of DDR3/DDRA is 
responded 

1’b0: The current request has been responded to 
1'b1: The current request is not being processed 


2. PHY Interface registers 

The internal registers of DDR PHY support DDR3 and DDRA, and the meaning is completely 
consistent with the protocol. For details, please refer to JESD79-3D, DDR3 SDRAM Standard[9], 
JESD79-4B, DDR4 SDRAM Standard[10]. 


2.6.2 Register access 


The internal registers of the Controller are accessed through the APB interface. The register 


data is passed through apb wdata and apb rdata through the address, and the register address is 


passed through apb addr. For the address value of each register, please refer to "2.6.1 Register 


Description". 


The access method of PHY internal register is the same as that of accessing Memory internal 


Mode Register register. 
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2.7 Typical application 
2.7.1 Single BANK-x16 typical application 


Only PHY 
ddrphy pp. slice top 
p mem dg 
ddrphy data, slice mem dgs 
phy. wrdata en S mem dqs n 
phy. wrdata 5 IOL x IOB £ mem dm 
phy. wrdata mask 
x16 DDR4 mem 
mem cs n 
mem cke 
phy cs n mem odt 
phy cke k 
dfi_wrdata* ddrphy_dfi phy_odt = 
ata* hy. act mem act n 
dfi rddata* p i E sa d 
p mem ba 
dfi addr/cmd[1:0] - phy ba IOL 10B mem be 
phy bg K— mem ck 
phy ck mem ck n 
phy. ras n - mem rst n 
phy cas n 
phy rst n 
BANK R7 


Figure 2-27 Schematic diagram of single BANK-x16 structure 


A typical application for a single BANK-x16 is shown in Figure 2-27. Single BANK-x16 is 
based on a certain HP BANK (R7 in the figure), and saves pins by removing some functional pins. 


Single BANK-x16 application has the following considerations: 


€ When the HARD FIFO function is enabled, only CKE is allowed to be placed on the 
dedicated calibration resistor pins (there are two dedicated calibration resistor pins in the 
HP BANK). 


€ Functional pins (CS n, TEN, PARITY, ALERT n) can be configured through the 
configuration interface, see "2.3.1 2(3) Step 3: Pin/Bank Options" for the configuration 


method. 
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2-x16 DDR4 mem 


T . . . 
2.7.2 Dual BANK-x32 typical application 
Only PHY 
ddrphy pp slice top 
" mem dq 
ddrphy. data slice mem dqs 
phy. wrdata en mem dqs n 
phy. wrdata IOL < IOB € mem dm 
phy. wrdata mask 
BANK R5 
mem cs n 
mem cke 
mem odt 
phy cs n 
phy. cke k 
dfi_wrdata* phy_odt mem_act_n 
dfi_rddata* ddrphy_dfi phy_act_n mem_a 
phy. addr mem ba 
dfi addr/cmd[1:0] hy ba: dud 
mem cl 
phy_bg IOL IOB mem ck n 
hy ck mem rst n 
phy ras n 
phy cas n 
phy rst n. 
> 
BANK R6 


Figure 2-28 Schematic diagram of dual BANK-x32 structure 


A typical application for dual BANK -x32 is shown in Figure 2-28. Dual BANK-x32 is based 


on two adjacent HP BANKs (R5, R6 in the figure), among which BANK R6 is used for CA channel, 


and the other BANK R5 is used for DQ channel. Dual BANK -x32 applications have the following 


considerations: 


€ Do not use the two dedicated calibration resistor pins in the HP BANK. 


€  Itis forbidden to distribute signals across banks. For specific Pin & Bank design rules, 


please refer to "UG050010 Titan2 Series HMIC S IP Application Guide" [12]. 
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2.7.3 Multy BANK-x64 typical application 


Only PHY 
ddrphy pp slice top 
. mem dq[31:0] 
ddrphy data, slice mem dqs[1:0] 
phy wrdata en y mem dgs n[1:0] 
phy. wrdata[8*32-1:0] IOL IOB K mem dm[1:0] 
| —— phy. wrdata mask[8"2-1:0] 
BANK R5 
2-x16 DDR4 
—— mem_cs_n 
phy_cs_n mem_cke 
phy_cke " mem odt 
dfi wrdata' phy. odt 
dfi rddata* phy act n mem act n 
phy. addr mem a 
dfi addr/cmd[1:0] phy. ba IOL IOB mem ba 
bih L mem bg 
ddrphy. pp. dfi Pay ? mem ck 
1 phy ck mem ck n 
phy ras n mem rst n 
phy cas n 
phy rst. n 
BANK R6 
mem dq[63:32] 
ddrphy. data, slice mem dgs[3:2] 2-x16 DDR4 
phy. wrdata en | mem dqs n[3:2] 
m mem mem dm[3:2] 
| — phy. wrdata[8*64-1:8*32] iL < IOB 
| — phy_1_wrdata_mask[8*4-1:842] | > 
BANK R7 


Figure 2-29 Schematic diagram of multi-bank-x64 structure 


A typical application for multi-bank-x64 is shown in Figure 2-29. Multi-BANK-x64 is based 
on two adjacent HP BANKs (R5, R6, R7 in the figure), of which BANK R6 is used for the CA 
channel, and the other BANK R5 and BANK R7 are used for the DQ channel. Multiple BANK-x64 


applications have the following considerations: 
€ Do not use the two dedicated calibration resistor pins in the HP BANK. 


€  Itis recommended that the CA signal be distributed on BANK R6 to ensure that the delay 
difference of the clock distribution path is relatively short. For specific Pin & Bank design 
rules, please refer to "UG050010 Titan2 Series HMIC S IP Application Guide" [12]. 


€ Under the Fly-by topology, ensure that the remote particle stub routing meets the design 


requirements as much as possible to ensure that the AC parameters can be covered. 
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2.7.4 Ping Pong PHY typical application 


Ping Pong PHY 
ddrphy pp slice top 
; mem dg 
ddrphy. data, slice mem, dqs 
phy. wrdata en mem dqs n 
phy. wrdata IOL IOB meri di 
| phy_wrdata_mask 
ais DDR4 mem 
dfi_wrdata* mem_cs_n 
dfi rddata* phy cs n mem cke 
mem odt 
phy. cke > G 
Dfi addr/cmd[1:0] phy_odt 
phy. act. n mem act n — — 
phy. addr mem a 
phy. ba mem ba 
«Bob mem bg b 
ddrphy pp. dfi PRYDE IOL ? IOB mem ck 
Dfi 1 addr/cmd[1:0] —— phy_ck mem_ck_n 
phy ras n - mem rst n 
Dfi 1 wrdata* —— phy cas n PR—— ET —— 
€— — DE 1 rddata* Phy_rst_n 
phy.l. cs n à Mem 1 es n 
phy. 1 cke —————5 Mem 1 cke 
phy. 1 odt Mem 1 odt 
DDR4 mem 1 
ddrphy data, slice 
phy. 1 wrdata en > 
phy. 1 wrdata > IOL IOB & Mem 1 dq 
phy 1 wrdata mask Mem 1. dqs 
Mem 1 dqs n 
Mem 1 dm 


Figure 2-30 Schematic diagram of Ping Pong PHY structure 


A typical application for Ping Pong PHY is shown in Figure 2-30. The Ping Pong PHY saves 
pins by sharing (mostly) the addr/cmd pins of both PHYs. The Ping Pong PHY application has the 


following considerations. 


€ In order to synchronize with the original design, Ping Pong PHY retains the original 


interface naming rules, and only adds * 1* to the newly added PHY for distinction. 


€  Thetwo DDR mems must be the same Component, and the parameter settings must be 


the same. 


€ On the DFI interface, the original four time slots of each cycle are allocated according to 
the following rules: time slot 0/2 belongs to DDR4 mem, and time slot 1/3 belongs to 
DDR4 mem 1. 


€ Complete the training of DDR mem first, and then complete the training of DDR mem 1. 


2.8 Instruction and Precautions 
2.8.1 AXIA Interface Burst Computing 
Start Address - ADDR; 


Burst. Length- len; 
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End Address = ADDR + len * 8. 


2.8.2 Clock constraints 

HMIC_S IP has multiple clocks that need to be constrained, namely ref_clk, rst_clk, 
ddrphy_sysclk, and phy_dq_sysclk (one for each BANK needs to be constrained), and the 
relationship between each clock is shown in Figure 2-31. For the specific constraint method, please 


refer to the .fdc file in the IP /pnr directory. 


Among them, ref_clk is the input reference clock, ddrphy_sysclk and rst_clk are obtained by 
multiplying the frequency of GPLL, and phy_dq_sysclk is obtained by multiplying the frequency 
of PPLL. ddrphy_sysclk is the system clock of IP soft logic, rst_clk is the driving clock of GPLL 
dynamic phase shift and reset sequence, phy dg sysclk is the BANK clock, each BANK has a 
PPLL, and the phy dg sysclk of the BANK is obtained by frequency division of the PPLL of the 
BANK. 


rst_clk 


ref_clk 


phy. dg sysclk 


ddrphy. sysclk 


phy. dq sysclk 


Figure 2-31 IP internal clock structure 


2.8.3 IO Constraints 
The position constraints on the internal modules of the chip need to be consistent with the 
position constraints provided by the .fdc file. The constraint positions cannot be changed, and the 


path can be modified according to the specific usage. 
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Constraints on parameters such as pin positions and level standards are carried out in UCE 
(User Constraint Editor). For specific parameter configuration, please refer to the .fdc file in the 


IP/pnr directory. Some requirements for pin parameter settings are as follows. 
€ VCCIO needs to be set to 1.5V or 1.2V (DDR3 is 1.5, DDR4 is 1.2); 
€ mem ckisa differential output signal, which needs to use SSTLI5D Ior POD12D level; 


€ mem dqs is a bidirectional differential signal, which needs to use SSTLI5D_I or 
POD12D level; 


€ The remaining signals are single-ended signals, which need to use SSTL15_I and POD12 


levels; 


€ mem dg isa bidirectional single-ended signal, it needs to configure the reference voltage 
VREF, it is recommended to use an external VREF, select VREF MODE as OUT, and 


then select the corresponding external VREF input pin; 


€ The mem dqs/mem dg signal needs to be matched by a terminal resistor on the FPGA 
side. It is recommended to use an internal terminal resistor, set DDR TERM MODE to 


ON, and set CP_DYN_TERM to ON; 
€ = The rest of the parameters can be set by default. 


2.8.4 Physical constraints 

The DDR project requires physical constraints, which can be edited directly through fdc, or 
manually constrained through the PCE (Physical Constraint Editor) tool. Physical constraint 
information is stored in .fdc files in the /pnr directory and is eventually passed to the pcf constraint 
file during layout. For the specific configuration method of the constraint file, please refer to the 
help document under the PDS installation path: User Constraint Editor User Guide[5], 
Physical_Constraint_Editor_User_Guide[6]. For example: 


define attribute (i:I ips ddr top.u ddrphy top.u ddrphy cpd} {PAP LOC] 


(DDRPHY CPD HP 669 310) 


define attribute (i:I ips ddr top.u ddrphy top.ddrphy gpll.u_gpll} (PAP LOC) 


(GPLL 667 463) 
2.8.5 dqs gate update function description 
When the temperature changes, the dqs phase in the read direction may change, causing the 
dqs gate window to shift, resulting in dqs gate errors, so it is necessary to perform dqs gate update 


operations regularly. 
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1. Timing description 


i 
E dqs gate update > | 


I I 
| | 
] 
RR: L 
dfi phyupd req... | | | | | | 
I 
dfi phyupd ack | | 
| I 
upd act ba dont care \\ X \\ valid Y dont care 
\ 
upd_act_bg dont care \\ Y || valid Y dont care 
I 
| | 
CA channel dont care Y | idle Y dont care 
] | 
DATA channel il | |] valid | 


Figure 2-32 Schematic diagram of dqs gate update 


When the dqs gate needs to update, it will pull up the dfi phyupd req signal and send a request 
to the controller. When the controller is ready to respond, it will pull up the dfi phyupd ack signal. 
At this time, ddrphy starts to execute the dqs gate update operation. After the update is completed, 
pull down the dfi phyupd req, and the controller detects dfi phyupd req Pull low after pull low 
dri phyupd ack. 


During the period when dfi_phyupd_ack is pulled high to dfi phyupd reg is pulled low, 
upd act, ba and upd act bg need to remain valid, the ca bus of dfi cannot send commands, and the 
read and write data bus of dfi is not restricted by dgs gate update, and ddrphy will automatically 
shield the read data during dgs gate update. 


2. Working mode 

The dgs gate update process needs to adjust the phase of the dgs gate, and then read the 
Memory data to determine whether the dgs gate is correct to determine whether the phase of the dgs 
gate needs to be adjusted. Considering that dgs gate update will occupy normal read and write 


bandwidth, dgs gate update has designed two working modes. 


Description: 


Users can choose the working mode of dgs gate update according to the actual Memory 


operation process to improve the efficiency of Memory operation. 


(1) Mode 1 

Before dfi phyupd ack is pulled high, to make Memory enter the Idle state, ddrphy first 
performs the Active operation, upd act ba and upd act bg decide which Bank is Active. By 
default, Active is row 0 of the selected Bank, then dqs gate update is performed, and finally 
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Precharge is executed. 


(2) Mode 2 

Controller can pull up dfi_phyupd_ack during reading and writing, tell ddrphy which Bank is 
currently Active through upd_act_ba and upd_act_bg, ddrphy directly executes dqs gate update, 
and then pulls down dfi_phyupd_req. 


3. Mode selection 
Both modes are selected by parameter GATE_ACT_PRE_EN. 


€ GATE ACT PRE EN = select mode 1; 

€ GATE ACT PRE EN z 0 select mode 2. 
2.9 IP Debuggin means 

Description: 


For more information about IP debugging, please refer to "UGO50010 'Titan2 Series HMIC S 
IP Application Guide" [12]. 


2.9.1 Key indication signals 
For some key information during the operation of DDRPHY, a single-bit indicator signal is 
made for easy observation, which can be connected to an external LED or monitored in other ways, 


and can guickly judge the operating status of DDRPHY. See Table 2-37 for key indication signal 


descriptions. 
Table 2-37 Key Indicator Signals 
Signal UO Width |Description 
pll lock O 1 PLL lock indication, high level means locked. 
ddrphy cpd lock O 1 cpd lock indication, high level means locked. 
dfi_init_complete O 1 The PHY has completed the training-related operations and is 
in the normal state. 
heartbeat signal. 
heart beat led O 1 When the ddrphy system clock is normal, it flashes once in 
about | second. 
(signal generated in Example Design) 
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Signal 


UO 


Width 


Description 


dfi bist run led 


Data flow indication signal. 

When the data flow is normal, the 213 beat data flashes once. 
This signal is stable at 0 or 1 when data flow is interrupted. 
(signal generated in Example Design) 


err_flag_led 


Data check error signal. 

1: There is an error in data detection, which needs to be 
cleared manually after the error is eliminated. 

0: No error in data detection. 

(signal generated in Example Design) 


2.9.2 Internal Status and Control Signals 


For some other non-real-time changing internal status signals and control signals used for 


debugging, see Table 2-17. These signals can be easily read and written through the serial port. 


Flexible debugging can be realized by developing companion scripts. 


Refer to "Figure 2-14 Example Design System Block Diagram" for the serial port access 


schematic diagram. The ips2l uart ctrl module in DDRPHY Example Design is a serial port 


communication module. The host computer realizes the read and write operations of internal status 


signals and control signals through the serial port and the ips2l uart ctrl module. 


The serial port configuration adopted by DDRPHY Example Design is shown in Table 2-38. 


Table 2-38 DDRPHY Example Design serial port configuration 


Baud rate Start bit Data bit Stop bit Check bit Flow control 
115200bps Ibit 8bit Ibit None None 
Description: 


A set of serial port scripts were developed during the internal debugging process, please 


contact AE to obtain them if necessary. 
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3.1 Reference Documentation 


[1] 
[2] 
[3] 
[4] 
[5] 
[6] 
[7] 
[8] 
[9] 


Pango Design Suite Quick Start Tutorial 


Pango Design Suite User Guide 


IP Compiler User Guide 
Simulation User Guide 

User Constraint Editor User Guide 
Physical Constraint Editor User Guide 
Route Constraint Editor User Guide 
UG050007. Titan2 Series GTP User Guide 


JESD79-3D, DDR3 SDRAM Standard 


[10] JESD79-4B, DDR4 SDRAM Standard 


[11] DDR PHY Inteface, DFI 3.1 Specification 


[12] UGO50010 Titan2 Series HMIC S IP Application Guide 


3.2 Glossary 


A 


APB Advanced Peripheral Bus 


AXI AdvancedeXtensible Interface 


D 


DDR Double Data Rate 


DFI DDR PHY Interface 


L 


LP Low Power 
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M 

MC Memory Controller 

MR Mode Register 


MRSMode Register Set 
P 


PHY Physical 
RD Read 


UI User Interface 


W 


WR Write 


3.3 List of abbreviations 


D 
DCDDDR Command Decode 


DCP DDR3 Command Procedure 
H 


HMIC High performance Memory Interface Controller 


IPC IP Compiler 
P 


PDS Pango Design Suite 


PCE Physical Constraint Editor 


U 


UCE User Constraint Editor 
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3.4 Statement 
3.4.1 Copyright Notice 
The copyright of this document is owned by Shenzhen Ziguang Tongchuang Electronics Co., 
Ltd., and all rights are reserved. Without written permission, any company or individual shall not 
disclose, reprint or otherwise disclose or distribute any part of this document to third parties. 


Otherwise, the company will pursue its legal responsibility. 


3.4.2 Disclaimer 
This document only provides phased information, and the content contained in it may be 
updated at any time according to the actual situation of the product without prior notice. The 
company does not assume any legal responsibility for any direct or indirect losses caused by 


improper use of this document. 


THIS DOCUMENT IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, 
INCLUDING ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
PURPOSE, OR NON-INFRINGEMENT, AND ANY WARRANTY ANY PROPOSAL, 
SPECIFICATION OR SAMPLE ARE OTHERWISE REFERENCED. No license, express or 


implied, to any intellectual property right is hereby granted by this document, whether by estoppel 


or otherwise. 


The company reserves the right to modify the relevant documents of the company's series of 


products at any time without prior notice. 
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